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PART 6 

CHAPTER 1 

INTRODUCTION TO THE MACRO ASSEMBLER 

This chapter presents a brief overview of some fundamental software concepts 
essential to efficient assembly language programming of the PDP-11 family of com- 
puters. A description of the hardware components of the PDP-11 family can be found 
in two DEC paperback handbooks. 

PDP-11 Processor Handbook 

PDP-11 Peripherals and Interfacing Handbook 

The user is also advised to obtain a PDP-11 Pocket Instruction List card for easy 
reference. (These items can be obtained from the Software Distribution Center.) 

Some notable features of MACRO are: 

1. Program and command string control of assembly functions. 

2. Device and filename specifications for input and output files. 

3. Error listing on command output device. 

4. Alphabetized, formatted symbol table listing. 

5. Relocatable object modules. 

6. Global symbols for linking between object modules. 

7. Conditional assembly directives. 

8. Program sectioning directives, 

9. User-defined macros. 

10. Comprehensive set of system macros. 

11. Extensive listing control. 

No attempt is made in this document to describe the PDP-11 hardware or the function 
of the various PDP-11 instructions. The reader is advised to become familiar with 
this material before proceeding. 

Assembly language programming deals directly with the host hardware. Therefore 
great care must be taken in specifying programming standards and conventions, if 
code written by different groups is to be easily interchanged. When a set of 
standards guides the entire programming process, the total programming effort 
becomes easier to plan, comprehend, test, modify, and convert. 
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The output of a MACRO assembly is a relocatable object module. LINK can bind one 
or more modules together and create an executable task. 

Once built, a program can generally be loaded and executed only at the address 
specified at LINK time. This is because LINK has had to make adjustments in some 
codes to reflect the memory locations in which the program is to run. 

It is possible to write a source program that can be loaded and run in any section 
of memory. Such a program consists of position-independent code. The construction 
of position-independent code is dependent upon the proper usage of PDP-11 addressing 
modes. (Addressing modes are described in detail in the Processor Handbook.) See 
Chapter 6-10 for an explanation on how to write position-independent code. 
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PART 6 
CHAPTER 2 . 
SOURCE PROGRAM FORMAT 

A source program is composed of a sequence of source lines, where each line contains 
a single assembly language statement. 

An assembly language line can contain up to 132 characters. Beyond this limit an 
I/O error is generated. 

2.1 STATEMENT FORMAT 

A statement can contain up to four fields, which are identified by order of appear- 
ance and delimited by certain terminating characters. The general format of a 
MACRO assembly language statement follows. 

[label:] [operator] [operand] [/comments] 

The label and comment fields are optional. The operator and operand fields are 
interdependent; either may be omitted depending upon the contents of the other. 
However, blank lines are legal. 

Some statements have one operand, for example, 

CLR R0 
while others have two. 

MOV #344, R2 

An assembly language statement must be complete on one source line. No continuation 
lines are allowed. 

MACRO source statements may use the TAB character to align the statement fields 
according to this standard format: 

label - column 1 

operator - column 9 

operand (s) - column 17 

comments - column 33 



For example: 



1 9 17 33 

REGTST: BIT #MASK, VALUE ;3 BITS? 
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2.1.1 Label Field 

A label is a user-defined symbol to which the assembler assigns the value of the 
current location counter and enters it into the user-defined symbol table. The 
value of the label may be either absolute or relocatable, depending on whether the 
location counter value is currently absolute or relocatable. (In the latter case, 
LINK assigns the absolute value of the symbol by adding the stated relocatable 
value to the relocation bias calculated by LINK.) 

A label is a means of symbolically referring to a specific location within a program. 
If present, a label always occurs first in a statement and must be terminated by a 
colon. For example, if the current location is absolute 100 (octal) , the assembler 
processes the statement 

ABCD: MOV A,B 

and assigns the value 100 (octal) to the label ABCD. Subsequent references to ABCD 
reference location 100 (octal) . In this example if the location counter were, re- 
locatable, the assigned value of ABCD would be 100 (octal) +K, where K is the location 
of the beginning of the relocatable section in which the label ABCD appears. 

A double colon defines the label as a global^ symbol that is accessible to independ- 
ently assembled modules; the statement 

ABCD:: MOV A,B 

establishes ABCD as a global symbol. 

More than one label may appear within a single label field; each label within the 
field references the same location. For example, if the current location counter 
is 100 (octal) , the multiple labels in the statement 

ABC: $DD: A7.7: MOV A,B 

causes each of the three labels ABC, $DD, and A7.7 to be assigned the value 
100 (octal) . 

The legal label characters are 

A - Z 
0-9 



(By convention, $ and . characters are reserved for use in system software symbols.) 
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The first six characters of a label are significant; An error message is generated 
if two or more' labels share the same first six characters. 

A symbol used as a label may not be redefined within the user program. An attempt 
to redefine a label results in an error flag (M) in the assembly listing. 

2.1.2 Operator Field 

An operator field follows the label field in a statement, and may contain a macro 
call , an instruction mnemonic , or an assembler directive . The operator may be 
preceded by none, one or more labels and may be followed by none, one or more 
operands and/or a comment. Leading and trailing spaces and tab characters are 
ignored. 

When the operator is a macro call, the assembler inserts the appropriate code to 
expand the macro. When the operator is an instruction mnemonic, it specifies the 
instruction to be generated and the action to be performed on any operand (s) that 
follow. When the operator is an assembler directive, it specifies a certain 
function or action to be performed during assembly. 

An operator is legally terminated by a space, tab, or any nonalphanumeric character. 

Consider the following examples. 

MOV A,B ; space terminates the operator MOV 
MOV@A,B ;@ terminates the operator MOV 

A blank operator field is interpreted as a .WORD assembler directive (see Section 
6-5.3.2). 

2.1.3 Operand Field 

An operand is that part of a statement that is manipulated by the operator. 
Operands may be expressions, numbers, symbolic names, or macro arguments (within 
the context of the operation). When multiple operands appear within a statement, 
each is separated from the next by one of the following characters: comma, tab, 
space, or paired angle brackets around one or more operands (see Section 6-3.1.1). 
An operand may be preceded by an operator, label, or other operand and followed by 
another operand or a comment. 

The operand field is terminated by a semicolon when followed by a comment, or by a 
statement terminator when the operand completes the statement. For example: 

LABEL: MOV A,B ; COMMENT 
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The tab between MOV and A terminates the operator field and begins the operand 
field; a comma separates the operands A and B; a semicolon terminates the operand 
field and begins the comment field. 

2.1.4 Comment Field 

The comment field is optional and may contain any ASCII characters except null, 
rubout, carriage return, line feed, vertical tab or form feed. All other characters, 
even special characters with a defined use, are ignored by the assembler when 
appearing in the comment field. 

The comment field may be preceded by any or none of the other three field types. 
Comments must begin with the semicolon character. 

Comments do not affect assembly processing or program execution, but are useful in 
source listings for later analysis, debugging, or documentation purposes. 

2.2 FORMAT CONTROL 

Horizontal or line formatting of the source program is controlled by the space and 
tab characters. These characters have no effect on the assembly process unless 
they are embedded within a symbol, number, or ASCII text; or unless they are used 
as the operator field terminator. Thus, these characters can be used to provide 
an orderly source program. 

LABEL: MOV (SP)+,TAG ;POP VALUE OFF STACK 

(See Section 6-5.1.2 for a description of page formatting with respect to macros, 
and Section 6-5.1.1 for a description of assembly listing output.) 
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PART 6 

CHAPTER 3 

SYMBOLS AND EXPRESSIONS 

This chapter describes the various components of legal MACRO expressions, the 
assembler character set, symbol construction, numbers, operators, terms, and 
expressions. 

3.1 CHARACTER SET 

The following characters are legal in MACRO source programs: 

1. The letters A through Z. Both upper and lower case letters are acceptable; 
although, upon input, lower case letters are converted to upper case 
letters. Lower case letters can only be output by sending their ASCII 
values to the output device. This conversion is not true for .ASCII, 
.ASCIZ, * (single quote) or " (double quote) statements if .ENABL LC 

is in effect. 

2. The digits through 9. 

3. The characters . (period or dot) and $ (dollar sign), are reserved 
for use in system program symbols. 

4. The special characters in Table 6-1. 



Table 6-1 
MACRO Special Characters 



Character 


Designation 


Function 


. . 


double colon 


Either the double colon or double equal 




double equal sign 


sign may be used to define a symbol as a 
global symbol (refer to Section 6-3.5). 


: 


colon 


label terminator 


- 


equal sign 


direct assignment indicator 


% 


percent sign 


register term indicator 




tab 


item or field terminator 




space 


item or field terminator 


# 


number sign 


immediate expression indicator 


§ 


at sign 


deferred addressing indicator 


( 


left parenthesis 


initial register indicator 


) 


right parenthesis 


terminal register indicator 


t 


comma 


operand field separator 



(continued on next page) 
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Table 6-1 (Cont.) 
MACRO Special Characters 



Character 


Designation 


Function 


i 


semicolon 


comment field indicator 


< 


left angle bracket 


initial argument or expression indicator 


> 


right angle bracket 


terminal argument or expression indicator 


+ 


plus sign 


arithmetic addition operator or auto- 




• 


increment indicator 


- 


minus sign 


arithmetic subtraction operator or auto- 
decrement indicator 


* . 


asterisk 


arithmetic multiplication operator 


/ 


slash 


arithmetic division operator 


& 


ampersand 


logical AND operator 


I 


exclamation 


logical inclusive OR operator 


■I 


double quote 


double ASCII character indicator 


i 


single quote 


single ASCII character indicator 


+ 


up arrow or 


universal unary operator, argument 




circumflex 


indicator 


\ 


backslash 


macro numeric argument indicator 



3.1.1 Separating and Delimiting Characters 

Reference is made in the remainder of the manual to legal separating characters 
and legal argument delimiters. These terms are defined in Tables 6-2 and 6-3. 



Table 6-2 
Legal Separating Characters 



Character 


Definition 


Usage 




space 


one or more spaces 
and/or tabs 

comma 


A space is a legal separator only for 
argument operands. Spaces within ex- 
pressions are ignored (see Section 
6-3.3). 

A comma is a legal separator for both 
expressions and arguments. 
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Table 6-3 
Legal Delimiting Characters 



Character 


Definition 


Usage 


<. ..> 

v.../ 


paired angle brackets 

up arrow construction 
where the up arrow 
character is followed 
by an argument 
bracketed by any 
paired printing 
characters 


Paired angle brackets are used to enclose 
an argument, particularly when that 
argument contains separating characters. 
Paired angle brackets may be used any- 
where in a program to enclose an ex- 
pression for treatment as a term. 

This construction is equivalent in 
function to the paired angle brackets 
and is generally used only where the 
argument contains angle brackets. 



Where argument delimiting characters are used, they must bracket the first (and, 
optionally, any following) argument (s). The character < and the characters +x, 
where x is any printing character, can be considered unary operators that cannot 
be immediately preceded by another argument. For example 



.MACRO 



TEM <AB>C 



indicates a macro definition with two arguments, while 

.MACRO TEL C<AB> 

has only one argument. The closing character (or matching character where the up 
arrow construction is used) acts as a separator. The opening argument delimiter 
does not act as an argument separator. 

Angle brackets can be nested as follows: 

D,<A<B>C> 
which reduces to: 

D,A<B>C 
and which ds considered to be two arguments in both forms. 
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3.1.2 Illegal Characters 

A character can be illegal in one of two ways: 

1. A character that is not recognized as an element of the MACRO character 
set is always an illegal character and causes immediate termination of 
the current line at that point and an error flag (I) in the assembly 
listing. For example in the statement 

LABEL*-* A: MOV A,B 

the backarrow is not a recognized character. The entire line is treated 
as 

.WORD LABEL 

and is flagged in the listing. 

2. A legal MACRO character may be illegal in context. Such a character 
generates a Q error on the assembly listing. 



3.1.3 Operators 

Table 6-4 shows legal unary operators under MACRO. 



Table 6-4 
MACRO Unary Operators 



Unary 
Operator 


Explanation 


+ 


plus sign, positive 
value 

minus sign, negative 
2*s complement value 

up arrow, universal 
unary operator 



The unary operators described in Table 6-4 can be used adjacent to each other in a 
term. 

Table 6-5 shows legal binary operators under MACRO. 
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Table 6-5 
MACRO Binary Operators 



Binary 


/ 


Operator 


Explanation 


+ 


addition 


- 


subtraction 


* 


multiplication 


/ 


division 


& 


logical AND 


1 


logical inclusive OR 



All binary operators have the same priority. Items can be grouped for evaluation 
within an expression by enclosure in angle brackets. Terms in angle brackets are 
evaluated first, and remaining operations are performed left to right. See the 
following examples. 



.WORD 1+2*3 
.WORD l+<2*3> 



;IS 11 OCTAL 
;IS 7 OCTAL 



3.2 TERMS 

A term is a component of an expression. A term may be one of the following. 

1. A number, as defined in Section 6-3.9. 

2. A symbol, as defined in Section 6-3.4. 

3. An ASCII conversion as defined in Section 6-5.3.3. 

4. An expression or term enclosed in angle brackets. Any quantity 
enclosed in angle brackets is evaluated before the remainder of the 
expression in which it is found. Angle brackets are used to alter 
the left-to-right evaluation of expressions (to differentiate between 
A*B+C and A*<B+C>) or to apply a unary operator to an entire expression 

(-<A+B>, for example) . 

3.3 EXPRESSIONS 

Expressions are combinations of terms and operators that reduce to a 16-bit value. 
The evaluation of an expression includes the evaluation of the mode of the resultant 
expression; that is, absolute, relocatable or external. 

Expressions are evaluated left to right with no operator hierarchy rules except 
that unary operators take precedence over binary operators. A term preceded by a 
unary operator can be considered as containing that unary operator. (Terms are 
evaluated, where necessary, before their use in expressions.) Multiple unary 
operators are valid and are treated as follows: 
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-+-A 

is equivalent to 

-<+<-A» 

A missing term, expression, or external symbol is interpreted as a zero. A missing 
operator terminates the expression analysis. A Q error flag is generated for each 
missing term or operator. For example: 

TAG! LA 177777 
is evaluated as 

TAG J LA 

with a Q error flag on the assembly listing line. 

The value of an external expression is the value of the absolute part of the ex- 
pression; e.g., EXTERNAL+A has a value of A. This is modified by LINK to become 
EXTERNAL+A. 

Expressions, when evaluated, are either absolute, relocatable, or external. For the 
programmer writing position-independent code, the distinction is important. 

1. An expression is absolute if its value is fixed. An expression whose 
terms are numbers and ASCII conversions will have an absolute value. 
A relocatable expression minus a relocatable term, where both items 
belong to the same program section, is also absolute. 

2. An expression is relocatable if its value is fixed relative to a base 
address but will have an offset value added at link time. Expressions 
whose terms contain labels defined in relocatable sections and periods 

(in relocatable sections) will have a relocatable value. 

3. An external expression is one whose partial definition at assembly time 
is completed at linking time. Also, an external expression is one whose 
terms may contain global symbols not defined in the current program. At 
linking time, external expressions containing relocatable global symbols, 
are considered relocatable; those containing absolute globals are con- 
sidered absolute. 

3.4 MACRO SYMBOLS 

There are three types of symbols: permanent, user-defined, and macro. MACRO 
maintains three types of symbol tables; the permanent symbol table (PST) , the user 
symbol table (UST) , and the macro symbol table (MST) . The PST contains all the 
permanent symbols and is part of the MACRO Assembler load module. The UST and MST 
are constructed as the source program is assembled. User-defined symbols are added 
to the table as they are encountered. 



6-12 



Symbols are interpreted according to the following hierarchy: 

a. A period causes the value of the current location counter to be used. 

b. A permanent symbol's basic value is used, but its arguments (if any) are 
ignored. 

c. An undefined symbol is assigned a value of zero and is inserted in the 
user-defined symbol table as an undefined global reference. If the 
.DSABL GBL directive is in effect, the automatic global reference 
default function is inhibited, and the symbol is not defined as a global 
reference. It remains undefined. Refer to Section 6-5.2. 

3.4.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics and assembler directives 
(see Chapter 6-5, 6-6, and 6-8). : These symbols are primitives of the assembler and 
need not be defined before being used in the source program. 

3.4.2 User-Defined and Macro Symbols 

User-defined symbols are those used as labels (Section 6-2.1.1) or defined by direct 
assignment (Section 6-3.5) . These symbols are added to the user symbol table as 
they are encountered during the first pass of the assembly. Macro symbols are 
those symbols used as macro names (Section 6-6.1). These symbols are added to the 
macro symbol table as they are encountered during the assembly. 

User-defined and macro symbols can be composed of alphanumeric characters, dollar 
signs, and periods only; any other character is illegal. 

The $ and . are in general use by system software, and the user is advised to avoid 
their use. 

The following rules apply to the creation of user-defined and macro symbols: 

1. The first character must not be a number (except in the case of local 
symbols, see Section 6-3.7) . 

2. Each symbol must be unique within the first six characters. 

3. A symbol can be written with more than six legal characters, but the 
seventh and subsequent characters are only checked for legality, and 
are not otherwise recognized by the assembler. 

4. Spaces, tabs, anfl illegal characters must not be embedded within a symbol. 

The value of a symbol depends upon its use in the program. A symbol in the operator 
field may be any one of the three symbol types. To determine the value of the 
symbol, the assembler searches the three symbol tables in the order Macro Symbol 
Table, Permanent Symbol Table, User Symbol Table. 
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A symbol found in the operand field is sought in the order User-Defined Symbol 
Table and Permanent Symbol. Table. 

These search orders allow redefinition of permanent symbol table entries as user- 
defined or macro symbols . The same name can also be assigned to both a macro and a 
label . 

User-defined symbols are either internal or external (global) . All user-defined 
symbols are internal unless they remain undefined internally or unless explicitly 
defined as being global with the .GLOBL directive or by the double-colon, or double- 
equal sign (see Section 6-5.10) . 

Global symbols provide links between object modules. A global symbol that is 
defined as a label is generally called an entry point (to a section of code) . Such 
symbols are referenced from other object modules to transfer control throughout the 
load module (which may be composed of a number of object modules) . 

Since MACRO provides program sectioning capabilities (Section 6-5.9), two types of 
internal symbols must be considered: symbols that belong to the current program 
section, and symbols that belong to other program sections. In both cases, the 
internal symbol must be defined within the current assembly; this is critical in 
evaluating expressions involving the second type of internal symbol (see Section 
6-3.3). 

3.5 DIRECT ASSIGNMENT 

A direct assignment statement associates a symbol with a value 1 When a direct 
assignment statement defines a symbol for the first time, that symbol is entered 
into the user symbol table (UST) . A symbol may be redefined by assigning a new 
value to a previously defined symbol. The latest assigned value replaces any 
previous value assigned to a symbol . 

The general format for a direct assignment statement follows: 

sym = expression 



sym == expression 

The second statement also defines sym as a global symbol . 

Symbols take on the relocatable or absolute attribute of their defining expression, 
However, if the defining expression is external, the symbol is not global unless 
explicitly defined as such in a .GLOBL directive, by a label delimited by a double 
colon, or by the double equal sign (see Section 6-5.10). Global references in an 
expression assigned to a symbol are illegal, and are flagged with an A error flag. 
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The following conventions apply to direct assignment statements. 

1. An equal sign (=) or double equal (==) must separate the symbol from the 
expression defining the symbol value. 

2. A direct assignment statement is usually placed in the label field and 
may be followed by a comment. 

3. Only one symbol can be defined in a single direct assignment statement. 

4. Only one level of forward referencing is allowed. 

Example of two levels of forward referencing (illegal) : 

X = Y 
Y = Z 
Z = 1 

3.6 REGISTER SYMBOLS 

The eight general registers of the PDP-11 are numbered through 7 and can be 
expressed in the source program as 

%0 
%1 



%7 

where the digit indicating the specific register can be replaced by any legal terra 
that can be evaluated during the first assembly pass. 

It is recommended that the programmer use symbolic names for all register references. 
Unless the .DSABL REG statement has been encountered, the definitions as shown in 
the following example are defined by default; alternatively, a register symbol may be 
defined in a direct assignment statement among the first statements in the program. 
The defining expression of a register symbol must be absolute. For example: 

R0=%0 ; REGISTER DEFINITION 

R1=%1 

R2=%2 

R3=%3 

R4=%4 

R5=%5 

SP=%6 

PC=%7 

The user can reassign the register expressions, if he wishes. 

The symbolic names assigned to the registers in the example above are the conven- 
tional names used in all PDP-11 system programs. Since these names are mnemonic, 
it is suggested the user follow this convention. Note that registers 6 and 7 are 
given special names because of their special functions. 
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All register symbols must be defined before they are referenced. A forward 
reference to a register symbol is flagged as an error. 

The % character may be used with any term or expression to specify a register. (A 
register expression less than or greater than 7 is flagged with an R error code.) 
For example, the statement. 

CLR %3+l 
is equivalent to 

CLR %4 
and clears the contents of register 4; while 

CLR 4 
clears the contents of memory address 4, 

3.7 LOCAL SYMBOLS 

Local symbols are specially formatted symbols used as labels within a given range. 

Local symbols provide a convenient means of generating labels for branch instruction, 
etc. Use of local symbols reduces the possibility of multi-defined symbols within 
a user program and separates entry point symbols from local references. Local 
symbols may not be referenced from other object modules or even from outside their 
local symbol block. The rules for delimiting a local symbol block appear below. 

Local symbols are of the form n$ where n is a decimal integer from 1 to 65535, 
inclusive, and can only be used on word boundaries (i.e., at even addresses) . Local 
symbols include the following. 

1$ 

27$ 

59$ 

104$ 

Within a local symbol block, local symbols can be defined and referenced. However, 
a local symbol cannot be referenced outside the block in which it is defined. 
There is no conflict with labels of the same name in other local symbol blocks. 

Local symbols 64$ through 127$ can be generated automatically as a feature of the 
macro processor (see Section 6-6.3.6 for further details). When using local 
symbols, the user is advised to first use the range from 1$ to 63$, or the range 
from 128$ to 65535$. 
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A local symbol block is delimited in one of the following ways: 

1. The range of a single local symbol block can consist of those statements 
between two normally constructed symbolic labels. (Note that a state- 
ment of the form 

LABEL= . 

is a direct assignment? it does not create a label in the strict sense, 
and does not delimit a local range.) 

2. The range of a local symbol block is always terminated upon encountering 
a .PSECT, .CSECT, or .ASECT directive. 

3. The range of a single local symbol block can be delimited with .ENABL LSB 
and the first symbolic label or .PSECT, .CSECT, or .ASECT directive 
following .DSABL LSB directive. 

For examples of local symbols and local symbol blocks, see Figure 6-1. 



Line 
Number 



Octal 
Expansion 



1 
2 

3 000000' .CSECT 

4 000000 IMPURE: 

5 000000' * .CSECT 

6 000000 IMPPAS: 

7 000000' .CSECT 

8 000000 IMPLIN: 
9 

10 000000' .CSECT 

11 00000 XCTPRG: 

12 00000 012100 MOV 

000000 • 

13 00004 005020 1$: CLR 

14 00006 022100 CMP 

000040 * 

15 00012 101374 BHI 
16 

17 000000' .CSECT 

18 00000 XCTPAS: 

19 00000 012700 MOV 



CLR 
CMP 

BHI 

.CSECT 

MOV 

CLR 
CMP 

BHI 

.CSECT 



Source Code 

.SBTTL SECTOR INITIALIZATION 



20 00004 005020 1$: 

21 00006 022700 

000040 ' 

22 00012 101374 
23 
24 

25 00000 XCTLIN: 

26 00000 012700 



27 00004 005020 1$: 

28 00006 022700 

000040 ' 

29 00012 101374 
30 

31 000000 « 



IMPURE 
IMPPAS 
IMPLIN 

XCTPRG 

# IMPURE, R0 

(R0) + 
#IMPTOP,R0 

1$ 

XCTPAS 

#IMPPAS,R0 

(R0) + 
#IMPTOP,R0 

1$ 

XCTLIN 

#IMPLIN,R0 

(R0) + 
#IMPTOP,R0 

1$ 
MIXED 



Comments 

; IMPURE STORAGE AREA 
; CLEARED EACH PASS 
; CLEARED EACH LINE 

; PROGRAM INITIALIZATION CODE 
; CLEAR IMPURE AREA 

;PASS INITIALIZATION CODE 
; CLEAR IMPURE PART 

;LINE INITIALIZATION CODE 



; MIXED MODE SECTOR 



Figure 6-1 
Assembly Source Listing of MACRO Code Showing Local Symbol Blocks 
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3.8 ASSEMBLY LOCATION COUNTER 

The period (.) is the symbol for the assembly location counter. When used in the 
operand field of an instruction, it represents the address of the first word of the 
instruction. When used in the operand field of an assembler directive, it represents 
the address of the current byte or word. For example: 



A: 



MOV 



#.,R0 



; . REFERS TO LOCATION A, 
I I.E., THE ADDRESS OF THE 
;MOV INSTRUCTION. 



(# is explained in Section 6-4.1.) 

At the beginning of each assembly pass, the assembler clears the location counter. 
Normally, consecutive memory locations are assigned to each byte of object data 
generated. However, the location where the object data is stored may be changed 
by a direct assignment altering the location counter. 

Example : 

.^expression 

The location counter symbol has a mode associated with it, either absolute or 
relocatable. The existing mode of the location counter cannot be changed by using 
a defining expression of a different mode. 

The mode of the location counter symbol can be changed by the use of the .ASECT, 
.CSECT or .PSECT directives as explained in Section 6-5.9.2. 

The expression defining the location counter must not contain forward references 
or symbols that vary from one pass to another. 

Examples : 



.ASECT 



.=500 



FIRST: MOV 



.+10, COUNTY 



,=520 



;SET LOCATION COUNTER 
; ABSOLUTE 500 

THE LABEL FIRST HAS THE VALUE 
500 (OCTAL) 

.+10 EQUALS 510 (OCTAL). THE 
CONTENTS OF THE LOCATION 
510 (OCTAL) WILL BE DEPOSITED 
IN LOCATION COUNTY. 

THE ASSEMBLY LOCATION COUNTER 
NOW HAS A VALUE OF 
ABSOLUTE 520 (OCTAL) 
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SECOND: MOV 



. , INDEX 



.PSECT 



■.+20 



THIRD: .WORD 



THE LABEL SECOND HAS THE 

VALUE 520 (OCTAL) 

THE CONTENTS OF LOCATION 

520 (OCTAL), THAT IS, THE BINARY 

CODE FOR THE INSTRUCTION 

; ITSELF, WILL BE DEPOSITED IN 

/LOCATION INDEX. 



;SET LOCATION COUNTER TO 
; RELOCATABLE 20 OF THE 
; UNNAMED PROGRAM SECTION. 

;THE LABEL THIRD HAS THE 
; VALUE OF RELOCATABLE 20. 



Storage area may be reserved by advancing the location counter. For example, if 
the current value of the location counter is 1000, the direct assignment statements 

.=.+40 
; or 

.BLKB 40 
; or 

.BLKW 20 

reserve 40 (octal) bytes of storage space in the program. The next instruction is 
stored at 1100., (The .BLKB and .BLKW directives are recommended as the preferred 
ways to reserve space. Refer to Section 6-5.5.3.) 

.3.9 NUMBERS 

The MACRO Assembler assumes all numbers in the source program are to be interpreted 
in octal radix unless otherwise specified. The assumed radix can be altered with 
the .RADIX directive (see Section 6-5.4.1) or individual numbers can be treated as 
being of decimal, binary, or octal radix (see Section 6-5.4.2) . 

Octal numbers consist of the digits through 7 only. A number not specified as a 
decimal number and containing an 8 or 9 is flagged with an N error code and treated 
as a decimal number. - 

Negative numbers are preceded by a minus sign (the assembler translates them into 
two's complement form) . Positive numbers may be preceded by a plus sign, although 
this is not required. 

A number that does not fit into 16 bits (n>177777) is truncated from the left and 
flagged with a T error code in the assembly listing. 
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Numbers are always considered absolute quantities (that is, not relocatable). 

Single-word floating-point numbers may be generated with the tF operator (see 
Section 6-5.6.2). Refer to PDP-11 Processor Handbook for details of the floating- 
point format. 

3.10 RELOCATION AND LINKING 

The output of the MACRO Assembler is an object module that must be processed by 
LINK before loading and execution. (See Part 9 of this manual for details.) LINK 
essentially fixes (i.e., makes absolute) the values of external or relocatable 
symbols and turns the object module into a load module. 

To enable the Linker to determine the value of an expression, the assembler issues 
certain directives to LINK, together with required parameters. In the case of 
relocatable expressions, LINK adds the base of the associated relocatable section 
(the location in memory of relocatable 0) to the value of the relocatable expression 
provided by the assembler. In the case of an external expression, LINK determines 
the value of the external term in the expression (since the external symbol must 
be defined in one of the other object modules which are being linked together) , and 
adds it to the value of the external expression provided by the assembler. 

All instructions that are to be modified (as described in the previous paragraph) 
are marked with an apostrophe in the assembly listing (see also Chapter 6-10) . Thus, 
the binary text output looks like the following. 



005065 CLR EXTERNAL (5) 



EXTERNAL+6(5) 



005065 CLR 
000006 ' 



005065 CLR RELOCATABLE ( 5 ) 
000040 * 



VALUE OF EXTERNAL SYMBOL 
ASSEMBLED ZERO; WILL BE 
MODIFIED BY LINK. 

THE ABSOLUTE PORTION OF THE 
EXPRESSION (000006) IS ADDED 
BY LINK TO THE VALUE 
OF THE EXTERNAL SYMBOL 

ASSUMING WE ARE IN A 

RELOCATABLE 

SECTION AND THE VALUE OF 

RELOCATABLE SYMBOL IS RELOCATABLE 40 

LINK WILL ADD 

THE RELOCATION BIAS TO 40 
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PART 6 

CHAPTER 4 

ADDRESSING INFORMATION 

Please refer to the PDP-11 Processor Handbook for complete information and examples 
concerning addressing modes. This chapter serves only to summarize that information, 

4.1 MODE FORMS AND CODES 

Each instruction takes at least one word. Operands of the forms listed in Table 6-6 
do not increase the length of an instruction. 



Table 6-6 
Address Modes - No Instruction Modification 



Op Code 



op 
op 
op 
op 
op 
op 



Operand 



R 


0n 


@R or (ER) 


In 


(ER) + 


2n 


@(ER) + 


3n 


-(ER) 


4n 


§-(ER) 


5n 



Mode 



Meaning 



Register mode 
Register deferred, mode 
Autoincrement mode 
Autoincrement deferred mode 
Autodecrement mode 
Autodecrement deferred mode 



n is the register number. 

However, any of the forms in Table 6-7 adds one word to the instruction length. 



Table 6-7 
Address Modes - Instruction Modifying 



Op Code 


Operand 


Mode 


Meaning 


op 


E (ER) 


6n 


Index mode 


op 


@E (ER) 


7n 


Index deferred mode 


op 


#E 


27 


Immediate mode 


op 


@#E 


37 


Absolute memory reference mode 


op 


E 


67 


Relative mode 


op 


@E 


77 


Relative deferred reference mode 



n is the register number. Ndte that in the last four forms, register 7 (the PC) 
is referenced. 



NOTE 

An alternate form for @R is (ER) . However, the 
form @(ER) is equivalent to @0(ER) . 

The form @#E differs from the form E in that the 
second or third word of the instruction contains 
the absolute address of the operand rather than 
the relative distance between the operand and the 
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PC. Thus, the instruction CLR @#100 clears 
absolute location 100 even if the instruction 
is moved from the point at which it was 
assembled. See the description of the .ENABLE 
AMA function in Section 6-5.2, which directs 
the assembly of all relative mode addresses as 
absolute mode addresses. 



4.2 BRANCH INSTRUCTION ADDRESSING 

The branch instructions are 1-word instructions. The high byte contains the op-code 
and the low byte contains an 8-bit signed word offset (seven bits plus sign) that 
specifies the branch address relative to the PC. The hardware calculates the branch 
address as follows: 

1. Extend the sign of the word offset through bits 8-15. 

2. Multiply the result by 2. This creates a byte offset from a word offset. 

3. Add the result to the PC to form the final branch address. 

The assembler performs the reverse operation to form the word offset from the 
specified byte address, when assembling the instruction. Remember that when the 
byte offset is added to the PC, the PC is pointing to the word following the branch 
instruction; hence the factor -2 in the following calculation. 

word offset = (E-PC)/2 truncated to eight bits. 

Since PC = .+2, we have 

word offset = (E-.-2)/2 truncated to eight bits. 

NOTE 

It is illegal to branch to a location specified as 
an external symbol, to a relocatable symbol from 
within an absolute section, or to an absolute or 
relocatable symbol or another program section from 
within a relocatable section. 

The EMT and TRAP instructions use the low-order byte of the instruction word for 
user-defined codes. This allows information to be transferred to the trap handlers 
via this low-order byte. If EMT or TRAP is followed by an expression, the value is 
put into the low-order byte of the word. However, if the expression is too big 
(>377 (octal) ) it is truncated to eight bits and a T error flag is generated. 
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PART 6 

CHAPTER 5 

GENERAL ASSEMBLER DIRECTIVES 

5.1 LISTING CONTROL DIRECTIVES 

5.1.1 .LIST and .NLIST 

Listing options can be specified in the text of a MACRO program through the .LIST 
and .NLIST directives. These are of the form 

.LIST [arg] 
.NLIST [arg] 

where arg represents one or more optional arguments. 

When used without arguments, the listing directives alter the listing level count. 
The listing level count causes the listing to be suppressed when it is negative. 
The count is initialized to zero, incremented for each .LIST and decremented for 
each .NLIST. For example: 

.MACRO LTEST ;LIST TEST 

A-THIS LINE SHOULD LIST 

.NLIST 
B-THIS LINE SHOULD NOT LIST 

.NLIST 
C-THIS LINE SHOULD NOT LIST 

.LIST 
D-THIS LINE SHOULD NOT LIST (LEVEL NOT BACK TO ZERO) 

.LIST 
E-THIS LINE SHOULD LIST (LEVEL BACK TO ZERO) 

.ENDM 

LTEST ;CALL THE MACRO 

; A-THIS LINE SHOULD LIST 

.NLIST 

.LIST 
; E-THIS LIST SHOULD LIST (LEVEL BACK TO ZERO) 

The primary purpose of the level count is to allow macro expansions to be selectively 
listed and yet exit with the level returned to the status current during the macro 
call. 

The use of arguments with the listing directives does not affect the level count; 
however, use of .LIST and .NLIST can be used to override the current listing control. 
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For example: 



.MACRO XX 



X=. 



.LIST 
.NLIST 



;LIST NEXT LINE 

;DO NOT LIST REMAINDER 

;OF MACRO EXPANSION 



.ENDM 
.NLIST ME 
XX 
.LIST 



;DO NOT LIST MACRO EXPANSIONS 
;LIST NEXT LINE 



X=. 



Allowable arguments for use with the listing directives appear in Table 6-8. These 
arguments can be used singly or in combination. 



Table 6-8 
MACRO Listing Directive Arguments 



Argument 


Default 


Function 


SEQ 


list 


Controls the listing of source line sequence numbers. 
Error flags are normally printed on the line preceding 
the questionable source statement. 


LOC 


list 


Controls the listing of the location counter (this 
field would not normally be suppressed) . 


BIN 


list 


Controls the listing of generated binary code. 


BEX 


list 


Controls listing of binary extensions; that is, those 
locations and binary contents beyond the first binary 
word (per source statement) . This is a subset of the 
BIN argument. 


SRC 


list 


Controls the listing of the source code. 


COM 


list 


Controls the listing of comments. This is a subset of 
the SRC argument and can be used tp reduce listing time 
and/or space where comments are unnecessary. 


MD 


list 


Controls listing of macro definitions and repeat range 
expansions . 


MC 


list 


Controls listing of macro calls and repeat range ex- 
pansions . 


ME 


no list 


Controls listing of macro expansions. 


MEB 


no list 


Controls listing of macro expansion binary code. A 
LIST MEB causes only those macro expansion statements 
producing binary code to be listed. This is a subset 
of the ME argument. 



(continued on next page) 
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Table 6-8 (cont.) 
MACRO Listing Directive Arguments 



Argument 


Default 


Function 


CND 

LD 
TOC 

TTM 
SYM 


list 

no list 
list 

console 
mode 

list 


Controls the listing of unsatisfied conditions and all 
.IF and .ENDC statements. This argument permits con- 
ditional assemblies to be listed without including 
unsatisfied code. 

Control listing of all listing directives having no 
arguments (those used to alter the listing level count) . 

Control listing of table of contents on pass 1 of the 
assembly (see Section 6-5.1.4 describing the .SBTTL 
directive) . The full assembly listing is printed during 
pass 1 of the assembly. 

Control listing output format. The TTM argument (the 
default case) causes output lines to be truncated to 
72 characters. Binary code is printed with the binary 
extensions below the first binary word. The alternative 
C.NLIST TTM) to terminal mode is line printer mode, 
which is shown in Figure 6-2 . 

Controls the listing of the symbol table for the assembly. 



An example of an assembly listing as sent to a 132-column line printer is shown in 
Figure 6-2 % Notice that binary extensions for statements generating more than one 
word are spread horizontally on the source line. An example of an assembly listing 
as sent to a teleprinter is shown in Figure 6-3. Notice that binary extensions 
for statements generating more than one word are printed on subsequent lines. 

The listing options can also be specified through switches on the listing file 
specification in the command string to the MACRO Assembler. These switches are 

/LI:arg 
/NL : arg 

where arg is any one or more of the arguments defined in the .LIST and .NLIST 
directive. 
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1 001766 GETLIN: 






2 001766 


SAVREG 




3 001772 016700 1$: 


MOV 


FFCNT,R0 


000020 ' 






4 001776 001420 


BEQ 


31$ 


5 002000 060067 


ADD 


R0,PAGNUM 


000022 • 






6 002004 012767 


MOV 


#-l,PAGEXT 


177777 






000026 • 






7 002012 005067 


CLR 


LINNUM 


000012 • 






8 002016 005067 


CLR 


FFCNT 


000020' 






9 002022 005067 


CLR 


SEQEND 


000016 " 






10 02026 005767 


TST 


PASS 


000000 * 






11 02032 001402 


BEQ 


31$ 


12 02034 005067 


CLR 


LPPCNT 


000010' 






13 02040 012702 31$: 


MOV 


#LINBUF,R2 


001712 ' 






14 02044 010267 


MOV 


R2,LCBEGL 


000012' 






15 02050 012767 


MOV 


#LINEND,LCENDL 


002116' 






000014 » 






16 


.IF NDF 


XSML 


17 02056 005767 


TST 


SMLCNT 


000200' 






18 02062 001145 


BNE 


40$ 


19 


.ENDC 




20 


.IF NDF 


XMACRO 


21 02064 016701 


MOV 


MSBMRP,R1 


002214 ' 






22 02070 001166 


BNE 


10$ 


23 


.IFTF 




24 02072 012701 


MOV 


#SRCBUF,Rl 


000756' 






25 02076 


.WAIT 


#SRCLNK 


26 02104 005267 


INC 


LINNUM 


000012 ' 






27 02110 116700 


MOVB 


SRCHDR+3,R0 


000753 ' 






28 02114 032700 


BIT 


#047, R0 


000047 






29 02120 001403 


BEQ 


32$ 


30 02122 


ERROR 


L 


31 02130 106100 32$: 


ROLB 


R0 


32 02132 100014 


BPL 


2$ 


33 02134 056767 


BIS 


CS1SAV,ENDFLG 


000006 ' 







;GET AN INPUT LINE 

;ANY RESERVED FF'S? 

; NO 

;YES, UPDATE PAGE NUMBER 



(INIT NEW CREF SEQUENCE 



;SEAT UP BEGINNING 

; AND END OF LINE MARKERS 

;IN SYSTEM MACRO? 
; YES, SPECIAL 

; ASSUME MACRO IN PROGRESS 
; BRANCH IF SO 



;GET CODE BYTE 

; ANYTHING BAD? 

; NO 

;YES, ERROR 

;EOF? 

; NO 



34 02142 001003 



BNE 



34$ 



Figure 6-3 

Example of Page Heading from MACRO Teleprinter Listing 

(same format as for 80 column line printer) 



6-27 



NOTE 

Where no listing file specification is in- 
dicated, any errors encountered are printed 
on the teleprinter. Where the /NL switch is 
used with no argument, the errors and symbol 
table are output to the device and/or file 
specified. Use of the switches /NL and 
/NL:SYM cause only the errors to be sent to 
the file and/or device specified. 

Each argument used with a listing switch is preceded by a colon. 

Use of these switches overrides the enabling or disabling of the equivalent listing 
option in the source. Default listing controls can be specified by the user within 
his source code and overridden, where necessary, by switch options at assembly time. 
For example: 

#OBJFIL , KB : /NL : BEX : COM/LI : SRC<DF : SRCFIL 

This command string suppresses the listing of binary extensions and source comments 
and ignores all listing directives with the arguments BEX, COM, and SRC. (The 
object file is sent to OBJFIL on the system device, and the listing and symbol 
table to the keyboard.) 

#OBJFIL , LP : /LKDT1 : ABC 

causes MACRO to ignore all .LIST and .NLIST directives without arguments. This 
command string causes the listing of any source code that would have otherwise been 
suppressed. (The object file is sent to the system device; the source listing and 
symbol table are sent to the line printer.) 

#0B JFIL , SYM/NL<ABC 

causes MACRO to produce only an object file and a symbol table listing. The 
assembly listing is completely suppressed by the /NL switch. (The object file and 
symbol table file are sent to the system device.) 

5.1.2 Page Headings 

The MACRO Assembler outputs each page in the format shown in Figure 6-3 (teleprinter 
listing) . On the first line of each listing page the assembler prints (from left 
to right) the following items. 

1. Title taken from .TITLE directive 

2. Assembler version identification 

3 . Date 
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4. Time-of-day 

5. Page number 

The second line of each listing page contains the subtitle text specified in the 
last encountered .SBTTL directive. 

5.1.3 .TITLE 

The .TITLE directive is used to assign a name to the object module. The name is 
the first symbol following the directive and must be six Radix-50 characters or 
less (any characters beyond the first six are ignored). Non-Radix-50 characters are 
not acceptable. For example, 

.TITLE PROG TO PERFORM DAILY ACCOUNTING 

causes the object module of the assembled program to be named PROG (this name is 
distinguished from the filename of the object module specified in the command 
string to the assembler) . The name of the object module appears in the LINK load 
map and on the listing. 

If there is no .TITLE statement, the default name assigned to the object module is 

.MAIN. 

The first tab or space following the .TITLE directive is not considered part of the 
object module name or header text, although subsequent tabs and spaces are 
significant. 

If there is more than one .TITLE directive, the last .TITLE directive in the program 
conveys the name of the object module, 

5.1.4 .SBTTL 

The .SBTTL directive is used to provide the elements for a printed table of contents 
of the assembly listing. The. text following the directive is printed as the second 
line of each of the following assembly listing pages until the next occurrence of a 
.SBTTL directive. For example: 

.SBTTL CONDITIONAL ASSEMBLIES 
The text 

CONDITIONAL ASSEMBLIES 
is printed as the second line of each of the following assembly listing pages. 
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During pass 1 of the assembly process, MACRO automatically prints a table of contents 
for the listing containing the line sequence number and text of each .SBTTL direc- 
tive in the program. Such a table of contents is inhibited by specifying the 
/NL:TOC switch option to the assembly listing file specification (or a .NLIST TOC 
directive within the source). For example: 

#0B JFIL , LISTM/NL : TOC<SRCFIL 

In this case the table of contents normally generated prior to the assembly listing 
is inhibited. 

An example of the table of contents is shown in Figure -6-4. Note that the first 
word of the subtitle heading is not limited to six characters since it is not a 
module name . 

5.1.5 .IDENT 

The .IDENT directive provides another means of labeling the object module produced 
as a result of a MACRO assembly. In addition to the name assigned to the object 
module with the .TITLE directive, a character string (up to six characters, treated 
like a RAD50 string) can be specified between paired delimiters. For example: 

.IDENT /V005A/ 

The character string 

V005A 

is converted to Radix-50 notatidh and included in the global symbol directory of 
the object module. 

This symbol is included in the load map listings" output by LINK. 

When more than one .IDENT directive is found in a given program, the last .IDENT 
found determines the symbol which is passed as part of the object module identi- 
fication. 
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5- 


1 


7- 


1 


12- 


1 


14- 


1 


16- 


1 


26- 


1 


36- 


1 


40- 


1 


41- 


1 


48- 


1 


50- 


1 


51- 


1 


59- 


1 


68- 


1 


72- 


1 


74- 


1 


75- 


1 


78- 


1 


79- 


1 


80- 


1 


88- 


1 


92- 


1 


93- 


1 


99- 


1 


103- 


1 


109- 


1 


114- 


1 


116- 


1 


135- 


1 



SECTOR INITIALIZATION 
SUBROUTINE CALL DEFINITIONS 
PARAMETERS 
ROLL DEFINITIONS 
PROGRAM INITIALIZATION 
ASSEMBLER PROPER 
STATEMENT PROCESSOR 
ASSIGNMENT PROCESSOR 
OP CODE PROCESSOR 

EXPRESSION TO CODE-ROLL CONVERSIONS 
' CODE ROLL STORAGE 
DIRECTIVES 

DATA-GENERATING DIRECTIVES 
CONDITIONALS 
LISTING CONTROL 
ENABL^DSABL FUNCTIONS 
CROSS REFERENCE HANDLERS 
LISTING STUFF 
KEYBOARD HANDLERS 
OBJECT CODE HANDLERS 
LISTING OUTPUT 
I/O BUFFERS 
EXPRESSION EVALUATOR 
TERM EVALUATOR 
SYMBOL/CHARACTER HANDLERS 
ROLL HANDLERS 
REGISTER STORAGE 
MACRO HANDLERS 
FIN 

Table of contents text is taken from the text of each .SBTTL 
directive. The associated numbers are the page and line sequence 
numbers of the .SBTTL directives. 



Figure 6-4 
Assembly Listing Table of Contents 

5.1.6 Page Ejection 

There are three ways of obtaining a page eject in a MACRO assembly listing. 

1. After a line count of 58 lines, MACRO automatically performs a page 
eject to skip over page perforations on line printer paper and to 
formulate terminal output into pages. 

2. More commonly, the .PAGE directive is used within the source code to 
perform a page eject at that point. The format of this directive 
appears here. 

.PAGE 

This directive takes no arguments and causes a skip to the top of the 
next page. 

Used within a macro definition, the .PAGE is ignored, but the page eject 
is performed at each invocation of that macro. 

3. The insertion of form feed characters (FF) cause page ejection. 
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5 . 2 FUNCTIONS : 



.ENABL AND .DSABL DIRECTIVES 



Several functions are provided by MACRO through the .ENABL and .DSABL directives, 
These directives use 3-character symbolic arguments to designate the desired 
function, and are of the forms 

•ENABL arg 
. DSABL arg 

where arg is one of the legal symbolic arguments as described in Table 6-9. 



Table 6-9 
Functions: Symbolic Arguments 



Argument 


Default 


Function 


ABS 


disable 


Produces absolute binary output; i.e., input to the 
paper tape software system absolute loader. 


AMA 


disable 


Causes the assembly of all relative addresses (address 
mode 67) as absolute addresses (address mode 37) . 
This switch is useful during the debugging phase of 
program development. 


CDR 


disable 


Causes source columns 73 and greater to be treated as 
comment. This accommodates sequence numbers in card 
columns 72-80. 


FPT 


disable 


Causes floating point truncation, rather than rounding, 
as is otherwise performed. .DSABL FTP returns to 
floating point rounding mode. 


LC 


disable 


Causes the assembler to accept lower case ASCII input 
" instead of converting it to upper case. 


LSB 


disable 


Causes a local symbol block to be started. See 
Figure 6-5. 


PNC 


enable 


Causes binary output to be produced on the source 
listing. 


REG 


enable 


Causes the default register names to be defined. The 
following code is implied as being present. 

R0=%0 
R1=%1 
R2=%2 
R3=%3 
R4=%4 
R5=%5 
SP=%6 
PC=%7 


GBL 


enable 


Causes the assembler to attempt to resolve undefined 
or global references at the end of pass 1. 
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A misspelled argument causes the directive containing it to be flagged as an error. 
No further action is taken. These functions can also be controlled through 
switches specified in the command string to the MACRO Assembler. The switches are 

/EN:arg 
/DSrarg 

where arg is any of the arguments that can be used with the .ENABL and .DSABL 
directives. 

Use of these switches overrides the enabling or disabling of all occurrences of 
that argument in the program. They are used in the same manner as /LI, /NL, but 
in general apply mainly to source files. 

5.3 DATA STORAGE DIRECTIVES 

The MACRO Assembler generates a wide range of data and data types. These facilities 
are explained in the following sections, 

5.3.1 .BYTE 

The .BYTE directive is used to generate one or more successive bytes of data. 

Format : 

.BYTE [expl] [ , exp2 , . . . ] 

A legal expression must have an absolute value (or contain a reference to an 
external symbol) and must result in eight bits or less of data. The 16-bit value 
of the expression must have a high-order byte (which is truncated) that is either 
all zeros or all ones. Each operand expression is stored in a byte of the object 
program. Multiple operands are separated by commas and stored in successive bytes. 
For example: 

SAM=5 
.=410 

.BYTE +D48,SAM -,060 (OCTAL EQUIVALENT OF 48 

; DECIMAL) IS STORED IN LOCATION 

I 410, 005, IS STORED IN 

; LOCATION 411. 

If the high-order byte of the expression equates to a value other than or -1, it 
is truncated to the low-order eight bits and flagged with a T error code. If the 
expression is relocatable, an A-type warning flag is given. 

At link time it is likely that relocation will result in an expression of more than 
eight bits, in which case, LINK prints a truncation error message. For example: 
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•BYTE 23 ; STORES OCTAL 23 IN NEXT BYTE. 
A: 

.BYTE A ; RELOCATABLE VALUE CAUSES AN "A" 

; ERROR FLAG. 

.GLOBL X 
X=3 

.BYTE X ; STORES 3 IN NEXT BYTE. 

If an operand following the .BYTE directive is null, it is interpreted as a zero. 
For example: 

* 

.=420 

.BYTE,, ; ZEROS ARE STORED IN BYTES 420, 421, 

;AND 422. 

5.3.2 .WORD 

The .WORD directive is used to generate one or -more -successive words of data. 

Format : 

.WORD [expl] [ ,exp2 , . . . ] 

A legal expression must result in 16 bits or less of data. Each operand expression 
is stored in a word of the object program. Multiple operands are separated by 
commas and stored in successive words. For example: 

SAL=0 
.=500 

.WORD 177535,. +4, SAL ;STORES 177535, 506 AND IN 

; WORDS 500, 502 AND 504. 

If an expression equates to a value of more than 16 bits, it is truncated and 
flagged with a T error code. 

If an operand following the .WORD directive is null, it is interpreted as zero. 
For example: 

.=500 

.WORD ,5, ; STORES 0, 5, AND IN LOCATIONS 

;500, 502, and 504 

A blank operator field (any operator not recognized as a macro call, op-code, 
directive or semicolon) is interpreted as an implicit .WORD directive. Use of this 
convention is discouraged because it may not be the default case in future PDP-11 
assemblers. The first term of the first expression in the operand field must not 
be an instruction mnemonic or assembler directive unless preceded by a + or - 
operator. For example: 
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.=440 

LABEL: +MOV, LABEL 



;THE OP -CODE FOR MOV, WHICH 
;IS 010000, IS STORED ON 
; LOCATION 440. 440 IS 
; STORED IN LOCATION 442. 



Note that the default .WORD directive occurs whenever there is a leading arithmetic 
or logical operator; or whenever a leading symbol is encountered that is not recog- 
nized as a macro call, an instruction mnemonic, or an assembler directive. There- 
fore, if an instruction mnemonic, macro call, or assembler directive is misspelled, 
the .WORD directive is assumed and errors will result. Assume that MOV is spelled 
incorrectly as MOR. 



MOR 



A,B 



Two error codes result: Q occurs because an expression operator is missing between 
MOR and A, and U occurs if MOR is undefined. The U error occurs only if GBL is 
disabled and MOR is undefined, else MOR is classed as a global. Two words are then 
generated: one for MOR A and one for B. 

5.3.3 ASCII Conversion of One or Two Characters 

The * and " characters are used to generate text characters within the source text. 
A single apostrophe followed by a character results in a word in which the 7-bit 
ASCII representation of the character is placed in the low-order byte and zero is 
placed in the high-order byte . For example , 



MOV 



#'A,R0 



results in the following 16 bits being moved into R0. 



0000 0000 0100 0001 



ASCII value of A 



STMNT: 



GETSYM 

BEQ 4$ 

CMPB @CHRPNT,#' 

BEQ LABEL 

CMPB @CHRPNT,#' 

BEQ ASGMT 



; COLON DELIMITS LABEL FIELD. 



; EQUAL DELIMITS 

; ASSIGNMENT PARAMETER. 



A double quote allows for the 7-bit ASCII representation of two characters to be 
placed in the low and high order bytes of a word. For example, 
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.WORD "AB 



results in the creation of the following binary word constant. 



0100 0010 0100 0001 



binary ASCII for A 
binary ASCII for B 



5.3.4 .ASCII 

The .ASCII directive translates character strings into their 7-bit ASCII equivalents 
for use in the source program. 

Format: 

.ASCII /character string/ 

where 



character string 



/ / 



is a string of any acceptable printable ASCII characters. 
The string may not include null, rubout, return, line 
feed, vertical tab, or form feed characters. Nonprinting 
characters can be expressed in digits of the current 
radix and delimited by angle brackets. Any legal, defined 
expression is allowed between angle brackets. 

these are delimiting characters and may be any printing 
characters other than ; < = or any character within the 
string . 



As an example: 
A: 



.ASCII /HELLO/ 



; STORES ASCII REPRESENTATION OF 
;THE LETTERS H E L L IN 5 
; CONSECUTIVE BYTES. 



.ASCII /ABC/<15><12>/DEF/ ; STORES A B C 15g 12 g D E F IN 8 

; CONSECUTIVE BYTES. 

; STORES < A B > IN 4 CONSECUTIVE 
; BYTES. 



•ASCII /<AB>/ 



The ; and = characters are not illegal delimiting characters, but are pre-empted 
by their significance as a comment indicator and assignment operator, respectively, 
For other than the first group, semicolons are treated as beginning a comment 
field. For example: 
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.ASCII ;ABC;/DEF/ 

.ASCII /ABC/;DEF; 

.ASCII /ABC/=DEF= 

.ASCII =DEF= 



;STORES A B C D E F 

;NOT RECOMMENDED PRACTICE 

; STORES ABC. DEF TREATED 
;AS A COMMENT 

;SAME AS CASE 1 

;THE ASSIGNMENT 

; .ASCII=DEF 

;IS PERFORMED AND A Q ERROR GENERATED 

;UPON ENCOUNTERING 

;THE SECOND =. 



5.3.5 .ASCIZ 

The .ASCIZ directive is equivalent to the .ASCII directive with a zero byte auto- 
matically inserted as the final character of the string. For example: 

When a list or text string has been created with a 
.ASCIZ directive, a search for the null character 
can determine the end of the list. For example: 



I 

2 
3 
4 
5 
6 
7 
8 
9, 

10 


; 


CALLED 


BY JSK PCfEXl 








ii 00000 


0i270t exu 

0000161 


MOV 


#HELLQ,K1 


12 00004 


012702 
000030' 


MOV 


#LIN6UF,H2 


13 00010 


112122 Xl 


Mova 


CK1)*,(K2)+ JMOVE DATA 


14 00012 


001376 


BNE 


X 


15 00014 


000207 


NTS 


PC 


16 


000015 CRM5 






17 


000013 IM13 






IB 00016 


015*H£LLOI 


•ASCIZ 


<CK»<LF»/HELLQ/<CKXLF> 


00017 


013 






00020 


110 






00021 


105 






00022 


114 






00023 


114 






00024 


117 






00025 


015 






00026 


013 






00027 


000 






19 00030 


CI'IBUM 


.blKW 


6 
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5.3.6 .RAD50 

The .RAD50 directive allows the user the capability to handle symbols in Radix-50 
coded form (this form is sometimes referred to as MOD40 and is used in PDP-11 system 
programs) . Radix-50 form allows three characters to be packed into sixteen bits; 
therefore, any 6-character symbol can be held in two words. 

Format : 

. RAD50 /string/ 

where 

/ / delimiters can be any printing characters other than the = 
< and ; characters. 

string is a list of the characters to be converted (three characters 
per word) and which may consist of the characters A through Z, 
through 9, $ . and space. If there are fewer than three 
characters (or if the last set is fewer than three characters) 
they are considered to be left justified and trailing spaces 
are assumed. Illegal nonprinting characters are replaced with 
a ? character and cause an I error flag to be set. Illegal 
printing characters set the Q error flag. 

The trailing delimiter may be a semicolon or matching delimiter. For example: 



.RAD50 /ABC/ 
.RAD50 /AB/ 
.RAD50 /ABCD/ 



PACK ABC INTO ONE WORD. 
PACK AB (SPACE) INTO ONE WORD. 
PACK ABC INTO FIRST WORD AND 
D SPACE SPACE INTO SECOND WORD. 



Each character is translated into its Radix-50 equivalent as indicated below. 

Character Radix-50 Equivalent (octal) 

(space) 

A-Z 1-32 4. 

$ 33 

34 
0-9 36-47 

The character code for 35 is currently undefined. 

The Radix-50 equivalents for characters 1 through 3 (C1,C2,C3) are combined as 
follows . 

Radix 50 value = ( (C*50g) +C2) *50 Q +C3 



For example: 



Radix-50 value of ABC is ((1*50 )+2)*50 8 +3 or 3223' 
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See Appendix B for a table of Radix-50 equivalents. 

Use of angle brackets is encouraged in the .ASCII, .ASCIZ, and .RAD50 statements 
whenever leaving the text string to insert special codes. For example: 

1 
2 

3 
4 
5 
6 
7 
6 

9 1000044 00328-5 ,RAQ50 /ABC/ ;STQRE$ 3223 

10 00046 003223 .RAOS0 /AB/<3» JEQUIVELENT TO /ABC/ 

11 000001 Vi»l 

12 000002 V2«2 

13 000003 V3»3 

14 00050 003223 ,RAO50 <V1»<V2><V3> 



5.4 RADIX CONTROL 

5.4.1 .RADIX 

Numbers used in a MACRO source program are initially considered to be octal numbers. 
However, the programmer has the option of declaring the radices 2, 4, 8, 10. This 
is done via the .RADIX directive, 

.RADIX [n] 

where n is one of the acceptable radices. 

The argument to the .RADIX directive is always interpreted in decimal radix. 
Following any radix directive, that radix is the assumed base for any number speci- 
fied until the following .RADIX directive. 

The default radix at the start of each program, and the argument assumed if none 
is specified, is 8 (i.e., octal). For example: 

.RADIX 10 ; BEGINS SECTION OF CODE WITH 

/DECIMAL 
;RADIX 



.RADIX ; REVERTS TO OCTAL RADIX 

In general it is recommended that macro definitions not contain or rely on radix 
settings from the .RADIX directive. The temporary radix control characters should 
be used within a macro definition and are described in the following section. A 
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given radix is valid throughout a program until changed. Where a possible conflict 
exists within a macro definition or in possible future uses of that code module , it 
is suggested that the user specify values using the temporary radix controls. 

5.4.2 Temporary Radix Control: +D, +0, and +B 

Once the user has specified a radix for a section of code, or has determined to use 
the default octal radix, he may discover a number of cases where an alternate radix 
is more convenient (particularly within macro definitions) . For example, the 
creation of a mask word might best be done in the binary radix. 

MACRO has three unary operators to provide a single interpretation in a given radix 
within another radix. 

+Dx (x is treated as being in decimal radix) 
tOx (x is treated as being in octal radix) 
+Bx (x is treated as being in binary radix) 

For example: 

+D123 

+0 47 

+B 00001101 

+0<A+3 . > 

Notice that while the up arrow and radix specification characters may not be 
separated, the radix operator can be physically separated from the number by spaces 
or tabs for formatting purposes. Where a term or expression is to be interpreted 
in another radix, it should be enclosed in angle brackets. 

These numeric quantities may be used any place where a numeric value is legal. 

MACRO provides a feature (maintained for compatibility with PAL-11) that allows 
temporary radix change from octal to decimal by specifying a decimal radix number 
with a decimal point. For example, 

100. 

1376. 

128. 

are all decimal numbers. 

5.5 LOCATION COUNTER CONTROL 

Four directives control movement of the location counter. .EVEN and .ODD move 
the counter a maximum of one byte. .BLKB and .BLKW allow the user to specify 
blocks of a given number of bytes or words to be skipped in the assembly. 
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5.5.1 .EVEN 

The .EVEN directive ensures that the assembly location counter contains an even 
memory address by adding one if the current address is odd. If the assembly loca- 
tion counter is even, no action is taken. Any operands following an .EVEN directive 
are ignored. 

5.5.2 .ODD 

The .ODD directive ensures that the assembly location counter is odd by adding one 
if it is even. For example: 



1 

2 








3 








4 








5 








6 








7 








8 00(9052 


001 ODfcVE* 


• BYTE 


1,2,3 


000053 


002 






00tt0t»4 


003 






9 




• EVEN 




10 00056 


001 


.BYTE 


1,2 


00fc)57 


002 






11 




.000 




12 00001 


001 


• BYTE 


1,2,3 


00062 


002 






00063 


0(43 






13 




• EVEN 




14 0W064 


£01 


• BYTE 


1,2,4 


00055 


002 






00055 


003 






15 




• 000 




16 00067 


001 


• BYTE 


1,2,3 


000/0 


002 






00071 


«J03 






17 




• EVEN 





MDJUST TO EVEN B0UN0RY 



JA0JUST TO 000 B0UN0RY 



JEVEN B0UNDRY? 



JQDD B0UNDRY? 



5.5.3 .BLKB and .BLKW 

Blocks of storage can be reserved using the .BLKB and .BLKW directives. .BLKB is 
used to reserve byte blocks and .BLKW reserves word blocks. 

Format: 



.BLKB 
.BLKW 



[exp] 
[exp] 



where exp is the number of bytes or words to reserve. If no expression is present, 
1 is the assumed default value. Any legal expression that is completely defined at 
assembly time and produces an absolute number is legal; e.g., external expressions 
are illegal. Using these directives without arguments is not recommended. 
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For example: 


1 


2 


3 000000 


4. 


5 000002 


6 000006 


7 000006 


8 000001 


9 000010 


10 00012 


11 


12 


13 00020 


14 00024 


15 00025 


16 00026 


17 00030 



000000 ' 



.CSECT IMPURE 



PASS: 


.BLKW 




SYMBOL 


.BLKW 


2 


MODE : 






FLAGS: 


.BLKB. 


1 


SECTOR 


.BLKB 


1 


VALUE: 


.BLKW 


1 


RELLVL 


.BLKW 


1 




.BLKW 


2 


CLCNAM 


.BLKW 


2 


CLCFGS 


.BLKB 


1 


CLCSEC 


.BLKB 


1 


CLCLOC 


.BLKW 


1 


CLCMAX 


.BLKW 


1 



;NEXT GROUP MUST STAY TOGETHER 
; SYMBOL ACCUMULATOR 

;FLAG BITS 

; SYMBOL/EXPRESSION TYPE 

EXPRESSION VALUE 

;END OF GROUPED DATA 

; CURRENT LOCATION COUNTER SYMBOL 



The .BLKB directive has the same effect as 

.=.+exp 
but is easier to interpret in the context of source code. 

5.6 NUMERIC CONTROL 

Several directives are available to simplify the use of the floating-point hardware 
on the PDP-11. (Refer to Processor Handbook for floating-point hardware descrip- 
tion.) 

A floating-point number is represented by a string of decimal digits. The string 
may contain an optional decimal point and an optional exponent indicator (the 
letter E and a signed decimal exponent) . The list below contains seven valid 
representations of the same floating-point number: 

3 

3. 

3.0 

3.0E0 

3E0 

.3E1 

300E-2 

The list could be extended indefinitely (e.g., 3000E-3, .03E2, etc.). A leading 
plus sign is ignored (e.g., +3.0 is considered to be 3.0) . A leading minus sign 
complements the sign bit. No other operators are allowed (e.g., 3.0+N is illegal). 

Floating-point number representations are valid only in the contexts described in 
the remainder of this section. 
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Floating-point numbers are normally rounded. That is, when a floating-point number 
exceeds the limits of the field in which it is to be stored, the high-order excess 
bit is added to the low-order retained bit. For example, if the number is to be 
stored in a 2-word field, but more than 32 bits are needed for its value, the 
highest bit carried out of the field is added to the least significant position. 
The .ENABL FPT directive is used to enable floating-point truncation, and .DSABL FPT 
is used to return to floating-point rounding (see Section 6-5.2) . 

5.6.1 .FLT2 and .FLT4 

Like the .WORD directive, the two floating-point storage directives cause their 
arguments to be stored in line with the source program. 

Format: 

. FLT2 ar gl , ar g2 , . . . 
. FLT4 argl , arg2 , . . . 

where argl,arg2, . . , represent one or more floating point numbers separated by 
commas . 

.FLT2 causes two words of storage to be generated for each argument, while .FLT4 
generates four words of storage. 

5.6.2 Temporary Numeric Control: +F and tc 

Like the temporary radix control operators, operators are available to specify 
either a 1-word floating -point number (+F) or the l's complement of a 1-word number 
C+C) . The +F operator can only be used within an instruction operand expression. 
fC can be used in any expression. For example, 

FL3.7: MOV #+F3.7,R0 

creates a 1 -word floating-point number at location FL3.7+2, containing the value 
3.7 formatted as follows, 

15 6 



SEEEEEEEEMMMMMMM 



mantissa (bits 0-6) 
1 — exponent (bits 7-14) 
-sign (bit 15) 

This 1-word floating-point number is similar to the first word of a 2- or 4-word 
floating-point number format shown in the PDP-11 Processor Handbook. The statement 
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CMP151: .WORD +C151 

stores the l's complement of 151 in the current radix (assume current radix is 
octal) as follows (177626 shown in binary) 



i ii i i 

t ljllljllljll0J01flSll0 



l! 7 ! 7 ! 6 ! 2 j 6 ! 
i i i i i i ■ 

Since these control operators are unary operators, their arguments may be terms, 
and the operators may be expressed recursively. For example: 

. +F<1.2E3> 
+C<D25> or +C31 or 177746 

The term created by the unary operator and its argument is then a term that can be 
used by itself or in an expression. For example, 

+C2+6 is equivalent to 177775 

while 

t<C2>+6 is equivalent to 177775+6 or 000003. 

For this reason, the use of angle brackets is advised. Expressions used as terms 
or arguments of a unary operator must be explicitly grouped. 

An example of the importance of ordering with respect to unary operators is shown 
below. 

+F1.0 = 020400 
+F-1.0 = 120400 

-fFl.0 - 157400 
-+F-1.0 = 057400 

The argument of the +F operator must not be an expression and must be of the same 
format as arguments" to the .FLT2 and .FLT4 directives (see Section 6-5.6.1). 

5.7 TERMINATING DIRECTIVES 

5.7.1 .END 

The .END directive indicates the physical end of the source program. 

Format: 

.END [exp] 
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where exp is an optional argument that indicates the program entry point; i.e., 
the transfer address. 

When the load module is loaded, program execution begins at the transfer address 
indicated by the .END exp directive. 

5.7.2 .EOT 

Under the DOS/BATCH Monitor, the .EOT directive is ignored. 

5.8 PROGRAM BOUNDARIES DIRECTIVE: .LIMIT 

It is often important to know the boundaries of the load module's relocatable code. 
The .LIMIT directive reserves two words into which LINK puts the low and high 
addresses of the relocated code. The low address (inserted into the first word) is 
the address of the first byte of code. The high address is the address of the first 
free byte following the relocated code. 

Example : 






•LIMIT 



;l!mit and LlMiT+i> 

MILL BE THE PROGRAM LIMITS 



5.9 PROGRAM SECTION DIRECTIVES 

The assembler provides for 255 program sections: one absolute section, one blank 
relocatable section, and 253 named relocatable sections. The .PSECT directive 
enables the user to create his program (object module) in sections, and share code 
and data. 

5.9.1 .PSECT Directive 

Program sections are defined by the .PSECT directive. 

Format: 

.PSECT [NAME] f ,RO/RW] [ ,I/D] [ ,GBL/LCL] [ ,ABS/REL] [ ,CON/OVR] [ ,HGH/LOW] 
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Any program section without a .PSECT directive is given the name .MAIN., and is 
assigned all the default attributes. Table 6-10 summarizes the program section 
attributes . 



Table 6-10 
.PSECT Directive Parameters 



Parameter 



NAME 

RO/RW 
I/D 

GBL/LCL 



Default 



blank 



RW 



LCL 



ABS/REL 



CON/OVR 



/LOW 



REL 



CON 



LOW 



Meaning to Linker 



Program section name, in Radix-50 format, specified 
as one to six characters. If omitted, a comma must 
appear in the first parameter's position. 

Defines the type of access to the program section 
permitted; read only or read/write. 

Allows LINK to differentiate global symbols that are 
entry points (I) from global symbols that are data 
values (D) . 

Defines the scope of a program section. A global 
program section's scope crosses segment (overlay) 
boundaries; a local program section's scope is within 
a single segment. In single-segment programs, the 
GBL/LCL parameter is ignored. 

When ABS is specified, the program section is ab- 
solute. No relocation is performed by the Linker 
for references within that section. When REL is 
specified, a relocation bias is calculated by LINK, 
and added to all references in the section. 

CON causes LINK to collect all allocation references 
to the program section from different modules and 
concatenate them to form the total allocation for 
the program section. OVR indicates that all alloca- 
tion references to the program section overlay one 
another. Thus, the total allocation of the program 
section is determined by the largest request made by. 
a module that references it. 

Program section memory type. 

HGH = high-speed 
LOW = core 



NOTE 



The HGH/LOW attribute is currently ignored by LINK. 



The first parameter must always be NAME. If it is omitted, a comma must be used 
in its place. 



Example ; 



.PSECT ,RO 
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This example shows a .PSECT with a blank name and the read only access parameter. 
Defaults are used for the remaining parameters. 

Once the attributes of a named .PSECT are declared in a module, the MACRO Assembler 
assumes that this .PSECT* s attributes hold for all subsequent declarations of the 
named .PSECT in the same module. Thus, the attributes may be declared once, and 
later .PSECT' s with the same name will have the same attributes , when specified 
within the same module. 

For each program section specified or implied, the assembler maintains the 
following information. 

1. Section name 

2. Contents of the program counter 

3. Maximum program counter value encountered 

4. Section attributes Cthe six .PSECT attributes) 

5.9.1.1 Creating Program Sections 

The attributes of a given program section are defined by explicit and default 
parameters upon its first reference. Thereafter, references to the section can 
either respecify the same section attributes, or the section name only. You may 
not assign different attributes on a later call to the section. For example, a 
section can be specified as 

.PSECT ALPHA, ABS,OVR 

which will give it the attributes ALPHA,RW,I,LCL,ABS,OVR,LOW. The same program 
can be later referenced as 

.PSECT ALPHA 

and the same attributes will still be in effect. 

By maintaining separate location counters for each section, the assembler allows 
the user to write statements which are not physically contiguous but are loaded 
contiguously, as shown in the following example. 
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t 

2 










3 










4 










5 










6 
7 










8 










9 










lid 




? 


CALLED 


BY J 


11 










12 




000000' 


.PSECT 


CLEAR, REL 


13 


tftfBtftf 


000000 A» 


.rtORO 





14 


00002 


00SMP0 Bl 


,*ORO 





15 


00(N4 


000000 Cl 


,WQRQ 





lb 


00006 


000000 Ui 


.tfURD 





17 










18 


000l0 


009467 ClNkJ 
177764 


CLK 


A 


19 


00014 


005^67 
177762 


CLK 


b 


2(0 


00020 


W050O7 
17 7760 


CLR. 


C 


21 










22 




000000' 


.PSECT 


VECTiABS 


23 




000004 I 


• «.+4 




24 


00004 


000000G 


. ^ORO 


TRAPP 


25 


000W6 


000360 


.WORD 


360 


26 










27 




000024' 


.psect 


CUEAR 


28 


00024 


00S0&7 
177/S6 


cl* 


D 


29 


00030 


k) v? if Ji Id 7 


Rrs 


PC 



J3R PCrCLRR 



;SECT. CUAR RELOCATABLE 
^POINTER VARIABLES 



;SET TO NULL 



JSECT.VECT ABSOLUTE 

^PRIORITY 7 
ISECT. CLEAR 

; RETURN 

The first appearance of a .PSECT directive with a given name assumes the location 
counter is at relocatable or absolute zero. The scope of each directive extends 
until a directive beginning a different section is given. Further occurrences of 
a section name in a subsequent .PSECT statement resume assembling where the section 
previously ended. 

All labels in an absolute section are absolute; all labels in a relocatable section 
are relocatable. The location counter symbol , is relocatable or absolute when 
referenced in a relocatable or absolute section, respectively. An undefined symbol 
is a global reference. It essentially has no attributes except global reference. 
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Any labels appearing on a .PSECT (or .ASECT or .CSECT) statement are assigned the 
value of the location counter before the .PSECT (or other) directive takes effect. 
Thus, if the first statement of a program is 

A: .PSECT ALT,REL 

then A is assigned to relocatable zero and is associated with the relocatable 
section ALT. 

Since it is not known at assembly time where the program sections are to be loaded, 
all references between sections in a single assembly are translated by the assembler 
to references relative to the base of that' section. The assembler provides LINK 
with the necessary information to resolve the linkage. This information is not 
necessary when making a reference to an absolute section. The assembler can 
determine all load addresses of an absolute section. 

In the following example, references to XI and Y are translated into references 
relative to the base of the relocatable section P2. 



1 

2 
3 
A 
5 








7 000(900 

8 tf 0t9 4 

9 

10 

U 00000 

12 00004 


000000' 
005067 AAAJ 

0000041 

W00167 

000000' 


.PSECT 

CLR 

JMP 


000000' 

000167 y; 

000000' 
0W0000 Xtt 


•PSECF 

JMP 

„ WQHO 



.PSECT P1,AB5 ;SfcCT, PI - ABSOLUTE 

XI fCLEAR XI IN RELOCATABLE SECTION 

Y IGOTO RELOCATABLE SECTION 



P2,RfcL ISECT. P2 « RELOCATABLE 
AAA JGOTQ ABSOLUTE SECTION 



5.9.1.2 Code or Data Sharing 

Named relocatable program sections with the attribute OVR can be used to redefine 
the same sections of core. Sections of the same name with the attribute OVR from 
different assemblies are all loaded at the same location by LINK. All other 
program sections (those with the attribute CON) are concatenated. 

Note that there is no conflict between internal symbolic names and program section 
names. It is legal to use the same symbolic name for both purposes. Program 
section names should not duplicate .GLOBL names. 
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5.9.2 .ASECT and .CSECT Directives 

DOS/BATCH assembly language programs use the .PSECT directive exclusively, since 
it affords all the capabilities of the .ASECT and .CSECT directives defined for 
other PDP-11 assemblers. For the sake of cpmpatibility with non-DOS/BATCH MACRO 
programs, the MACRO Assembler will accept .ASECT and .CSECT directives, but 
assembles them as if they were . PSECT* s with the default attributes listed in 
Table 6-11. 



Table 6-11 
Non-DOS/BATCH Program Section Defaults 



Attribute 


Default Value 


.ASECT 


.CSECT (named) 


.CSECT 


Name 


ABS 


name 


blank 


Access 


RW 


RW 


RW 


Type 


I 


I 


I 


Scope 


GBL 


GBL 


LCL 


Relocation 


ABS 


REL 


REL 


Allocation 


• OVR 


OVR 


CON 


Memory 


LOW 


LOW 


LOW 



The allowable syntactical forms of .ASECT and .CSECT follow here. 

.ASECT 

.CSECT [symbol] 

Note that, due to default attribute selection applied to .CSECT" s by MACRO, 

.CSECT JIM 
is identical to 

.PSECT JIM, GBL, OVR, RW, I, REL, LOW. 

5.10 SYMBOL CONTROL: .GLOBL 

The assembler produces a relocatable object module and a listing file containing 
the assembly listing and its associated symbol table. LINK joins separately 
assembled object modules into a single load module. Object modules are relocated 
as a function of the specified base of the load module. The object modules 
(where there are more than one) are linked via global symbols such that a global 



6-52 



symbol in one module (either defined by direct assignment or as a label) can be 
referenced from another module. 

A global symbol may be specified in a .GLOBL directive. 

In addition, symbols referenced but not defined within a module are assumed to be 
global references. The .GLOBL directive is provided to reference (and provide 
linkage to) symbols not otherwise referenced within a module. For example, one 
might include a .GLOBL directive to cause linkage to a library. When defining a 
global definition, the .GLOBL A,B,C directive is equivalent to the following. 

A==value (or A: : value) 
B== value (or B::value) 
C==value (or C::value) 

The form of the .GLOBL directive is 

.GLOBL syml , sym2 , . . . 

where syml , sym2 , . . . are legal symbolic names, separated by commas or spaces where 
more than one symbol is specified. 

Symbols appearing in a .GLOBL directive are either defined within the current 
program, or are external symbols defined in another program. This other program 
is linked with the current program by LINK prior to execution in order to resolve 
all references to external symbols. 

A .GLOBL directive line may contain a label in the label field and comments in the 
comment field. 

At the end of assembly pass 1, MACRO has determined whether a given global symbol 
is defined within the program or is an external symbol. All internal symbols to a 
given program must be defined by the end of pass 1, or they will be assumed to be 
global references (see .ENABL, .DSABL or globals in Section 6,-5.2). 

1 
2 
3 
4 
5 
5 

7 t ROUTINE WITH TWO ENTRIES 

8 ', DEPENDING ON NUMBER OF FOLLOWING ARGUMENTS 

9 I CALLED BY J3R R5,EN3 FOR THREE ARGS, 

10 1 CALLED BY J*»R R5,EN2 FOR TWO ARG$. 
11 

12 010014 6 k1l3»40 tNTa* NOV #CR5)+»»lSP) ?GET FIRST PARAM 

13 00010 00476/ JSK PCCDNV TCONVERT IT 

00000'^ « 

14 0001*4 012&7S MOV CSP) + ,0(K5) JPASS IT SACK 

000000 

15 00020 012535 EN12I MOV C*5) + , ? C*5) + JSENO PARAM 

16 00022 000205 NTS R5 , fRETUHN 
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References to external symbols can appear in the operand field of an instruction or 
an assembler directive in the form of a direct reference, 

.GLOBL EXT 

CLR EXT 

.WORD EXT 

CLR @EXT 

or a direct reference plus or minus a constant. 

.GLOBL EXT 

A=6 

CLR EXT+A 

.WORD EXT-2 

CLR @EXT+A 

An external symbol cannot be used in the evaluation of a direct assignment 
expression. Exception: a global symbol defined within the program can be used in 
the evaluation of a direct assignment statement,. 

5.11 CONDITIONAL ASSEMBLY DIRECTIVES 

Conditional assembly directives provide the programmer with the capability to 
conditionally include or ignore blocks of source code in the assembly process. 
This technique is used to allow several variations of a program to be generated 
from the same source program. 



The general, form of a conditional block follows. 
.IF 



.ENDC 



cond, argument (s) ; START CONDITIONAL BLOCK 
; RANGE OF CONDITIONAL 

; BLOCK 

;END CONDITIONAL BLOCK 



where 



cond is a condition which must be met if the block is to be included 

in the assembly. These conditions are defined in Table 6-12. 

argument (s) are a function of the condition to be tested. 

range is the body of code that is included in the assembly (or 

ignored) depending upon whether the condition is met. 
Conditional assembly blocks must end with the .ENDC directive, 
and are limited to a nesting depth of 16 levels. 
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Table 6-12 
Conditional Assembly Directives 



Conditions 






POSITIVE COMPLEMENT 


ARGUMENTS 


ASSEMBLE BLOCK IF 


EQ NE 


expression 


expression=0 (or 0) 


GT LE 


expression 


expressions (or <0) 


LT GE 


expression 


expression^ (or >0) 


DF NDF 


symbolic argument 


symbol is defined (or 
undefined) 


B NB 


macro -type 
argument* 


argument is blank (or 
nonblank) 


IDN DIF 


two macro-type 
arguments separated 
by a comma 


arguments identical (or 
different) 


Z NZ 


expression 


same as EQ/NE 


G L 


expression 


same as GT/LE 


*A macro-type argument is enclosed in angle brackets or within an 
up-arrow construction (as described in Section 6-6.3.1) . For example: 


<A,B,C> 
V124/ 




- 



i 

2 

3 
4 
5 
6 
7 
8 
9 

14 
11 
U 
13 



800000 ALPHAS 



Wtfiddirtl 



ic) w fe) 3 7 / 



.IP OF, ALPHA 

BETA*1 

.ENQC 

•IF EQ f AtPHA 

BETA*377 

.ENDC 



Within the conditions DF and NDF the following two operators are allowed to group 
symbolic arguments. 

& logical AND operator 

I logical^ inclusive OR operator 
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1 

3 








4 








5 








6 








7 


tf00Wdd 


SYM3*® 




8 






,IF NQF f SYMiiSYH2iSYM3 


9 


0000153 




ALPHA«14J 


10 






.ENOC 


11 






t IF NUF,5>YM11SYH2 


ia 


(90001& 




AtPHA«lS 


13 . 






,£NQC 



5.11.1 Subconditionals 

Subconditionals may be placed within conditional blocks to indicate the following. 

1. Assembly of an alternate body of code when the condition of the block 
indicates that the code within the block is not to be assembled. 

2. Assembly of a noncontiguous body of code within the conditional block 
depending upon the result of the conditional test to enter the block. 

3. Unconditional assembly of a body of code within a conditional block. 
These subconditional directives are defined in Table 6-13. 



Table 6-13 
Subconditional Directives 



Directive 


Function 


.IFF 
.IFT 
.IFTF 


The code following this statement up to the next sub- 
conditional or end of the conditional block is included in 
the program, provided the value of the condition tested 
upon entering the conditional block was false. 

The code following this statement up to the next sub- 
conditional or end of the conditional block is included 
in the program, provided the value of the condition 
tested upon entering the conditional block was true. 

The code following this statement up to the next sub- 
conditional or the end of the conditional block is 
included in the program, regardless of the value of the 
condition tested upon entering the conditional block. 



The implied argument of a subconditional directive is the value of the condition 
upon entering the conditional block. Subconditionals are used within outer level 
conditional blocks. They are ignored within nested, unsatisfied conditional blocks. 
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i 










2 










3 










4 








• 


5 










e 










7 










8 




000001 


SYMt«i 




9 






• If- 


QF,SYM1 


10 






.IFF 




U 






MOV 


R1,R2 


12 






• IFT 




13 


00032 


0l02fc3 


MOV 


R2,R3 


H 






,IFTF 




15 


00034 


010304 


MOV 


R3,R4 


16 






.ENOC 




17 










lb 






• IF 


NErSfMi 


19 






• IFF 




20 






MOV 


R4,R5 


21 






• IFT 




22 


0003S 


010501 


HOV 


Rt?,Rl 


23 






• ENOC 





MSSfcMBLE IF SYM1 UNDEFINED 
^ASSEMBLE XF 8YM1 DEFINED 
M8SEMBLE ALWAYS 

MSSEMBL.ED IF 8YM1 ■ 
M^SEMBLED IF SYM1 # 



5.11.2 Immediate Conditionals 

An immediate conditional directive is a facility for writing a conditional block in 
one line. In this form, no .ENDC statement is required and the condition is com- 
pletely expressed on the line containing the conditional directive. Immediate 
conditions are of the form 

.IIF cond, arg, statement 

where 



cond 



arg 



statement 



is one of the legal conditions defined for conditional blocks 
in Table 6^12. 

is the argument associated with the conditional specified; that 
is, either an expression, symbol, or macro-type argument, as 
described in Table 6-12. 

is the statement to be assembled if the condition is met. 



For example: 

.IIF DF FOO BEQ ALPHA 
This statement generates the code 

BEQ ALPHA 
if the symbol FOO is defined. 
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A label must not be placed in the label field of the .IIP statement. Any necessary 
labels may be placed on the previous line. 

LABEL: 

.IIF DF FOO,BEQ ALPHA 

.IIF DF FOO, LABEL: BEQ ALPHA 

5.11.3 PAL-11R Conditional Assembly Directives 

In order to maintain compatibility with programs developed under PAL-11R, the 
following conditionals (see Table 6-14) remain permissible under MACRO. It is 
advisable that future programs be developed using the format for MACRO conditional 
assembly directives. 



Table 6-14 
PAL-11R Compatible Directives 



Directive 


Arguments 


Assemble Block if 


.IFZ or .IFEQ 


expression 


expression^ 


.IFNZ or .IFNE 


expression 


expression not equal 


.IFL or .IFLT 


expression 


express ion<0 


.IFG or .IFGT 


expression 


express ion>0 


.IFLE 


expression 


expression is < or =0 


. IFDF 


logical expression 


expression is true (defined) 


.IFNDF* 


logical expression 


expression is false (undefined) 



The rules governing the usage of these directives are the same as those for the 
MACRO conditional assembly directives previously described. 
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PART 6 
CHAPTER 6 

MACRO DIRECTIVES 



6.1 MACRO DEFINITION 



In assembly language programming, it is often convenient to generate a recurring 
code sequence by means of a single statement. In order to do this, the desired 
coding sequence is first defined as a prototype with dummy arguments. This proto- 
type definition is known as a macro. Once a macro has been defined, it is invoked 
by a single statement that contains its name and, optionally, a list of real 
arguments that replaces the corresponding dummy arguments, in the prototype 
definition. Calling a macro causes its prototype statements to be generated in 
line, replacing the single macro call. 

6.1.1 .MACRO 

The first statement of a macro definition must be a .MACRO directive. The .MACRO 
directive is of the form 

.MACRO name[, dummy argument list] 
where 



name 



dummy 



is the name of the macro. . This name is any legal symbol. The 
name chosen may be used as a label elsewhere in the program. 

represents any legal separator (generally a comma or space) . 

dummy represents zero, one, or more legal symbols which may appear 
argument anywhere in the body of the macro definition, even as a label, 
list These symbols can be used elsewhere in the user program with no 
conflicts of definition. Where more than one dummy argument is 
used, they are separated by any legal separator (generally a 
comma) . 

A comment may "follow the dummy argument list in a statement containing a .MACRO 
directive. For example: 

.MACRO ABS,A,B ; DEFINE MACRO ABS WITH TWO ARGUMENTS 

A label must not appear on a ..MACRO statement. Labels are sometimes used on macro 
calls, but serve no function when attached to .MACRO statements. 
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6.1.2 .ENDM 

The final statement of every macro definition must be an .ENDM directive of the 
form 

.ENDM [name] 



where 



name 



is an optional argument, being the name of the macro terminated 
by the statement. 



For example: 

.ENDM (terminates the current macro definition) 
.ENDM ABS (terminates the definition of the macro ABS) 

If specified, the symbolic name in the .ENDM statement must correspond to the one 
in the matching .MACRO statement. Otherwise the statement is flagged and processing 
continues. Specification of the macro name in the .ENDM statement permits the 
assembler to detect missing .ENDM statements or improperly nested macro definitions. 

The .ENDM statement may contain a comment field, but must not contain a label. 
Example : 



1 

2 










$ 










A 










5 










6 










7 






.MACNQ 


TYP£#MESS 


a 






JSR 


Rb,TYPE JGUTPUT MESSAGE 


9 






.*QRD 


MESS 


10 






• ENQM 




n 










12 


00040 




TYPE 


HfcULU 




440040 


000000G 


JSK 


R5,TYPE fOUTPUT MESSAGE 




0044 


0fe)00l6' 


.NQ8D 


HELLU 


13 











6.1.3 .MEXIT 

In order to implement alternate exit points from a macro (particularly nested 
macros) , the .MEXIT directive is provided. .MEXIT terminates the current macro as 
though an .ENDM directive were encountered. Use of .MEXIT bypasses the complica- 
tions of conditional nesting and alternate paths. For example: 
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1 

2 
3 
4 
5 
6 
7 
8 
9 MOV rt«n»RT'K fRESET PARAM 

10 

11 

12 

13 MOV RT'N»-(SP) JSET UP RETURN 

14 

15 

16 00046 

00046 016767 

000014 

000016 



•MACRO 


ALTR,N,M»R 


MOV 


RT'N»RT'R 


.IF 


EU,N 


,Mtxir 




.ENOC 




MOV 


RT'N»-(SP) 


• ENQM 




ALTR 


0a, 2 


MOV 


RT0,RT2 ?RI 


.IF 


EU,0 


.MEXIT 




• ENOC 




MOV 


RT0,*CSP) 


AUTR 


1#2,3 


MOV 


RTl f RT3 ?RI 


.IF 


£Q,1 


, MEXIT 




.ENOC 




MOV 


RT1,-CSP) 


.WORD 





.WORD 





.WORD 





.WORD 






?SfcT UP RETURN 



17 00064 

00064 016767 
000010 
000012 



00062 016/46 MOV RT1,-(SP) jstT UP RETURN 

000002 

18 

19 00006 000000 RTWI 

20 00070 000000 RT1J 

21 00072 000000 RT2J 

22 000/4 0001000 RT3: 



In an assembly where N=0, the .MEXIT directive terminates the macro expansion. 

Where macros are nested, a .MEXIT causes an exit to the next higher level. A .MEXIT 
encountered outside a mcaro definition is flagged as an error. 

6.1.4 MACRO Definition Formatting 

<. ■ /■ -■ , 

A form feed character used as the only character on a line causes a page eject. Used 
within a macro definition, a form feed character causes a page eject. A page eject 
is not performed when the macro is invoked. 

Us,ed within a macro definition, the .PAGE directive is ignored, but a page eject is 
performed at invocation of that macro. 
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6.2 MACRO CALLS 

A macro must be defined prior to its first reference. Macro calls are of the 
general form 

[label:] name[, real arguments] 



where 



label 



name 



represents an optional statement label. 

represents the name of the macro specified in the .MACRO directive 
preceding the macro definition. 

, represents any legal separator (comma, space, or tab). No separator 
is necessary where there are no real arguments. 

real are those symbols, expressions, and values that replace the dummy 
arguments arguments in the .MACRO statement. Where more than one argument 
is used, they are separated by any legal separator. 

Where a macro name is the same as a user label, the appearance of the symbol in the 
operation field designates a macro call, and the occurrence of the symbol in the 
operand field designates a label reference . For example : 



1 

2 












3 












4 












5 












6 








, MACRO 


AB3,NUM 


7 








.WORD 


NUM 


H 








.ENOM 




9 












ltt 


0/jfcl2b 


Wlltfil 


AB5S 


MOV 


*R0,*R1 


11 


0¥}0»J0 


M\677$ 




BR 


ABS 


12 


I0tt!032 




UStl 






13 


0Wfe3d2 






ABS 


4 




$m<sz 


000004 




.WORD 


4 


14 


000^4 


Wliatl 




hQv 


0R0,«»R1 



;ABS AS A LABEL 
?ABS AS AN OPERAND 

MBS AS A MACRO CALL 



Arguments to the macro call are treated as character strings whose usage is determined 
by the macro definition. 

6.3 ARGUMENTS FOR MACRO CALLS AND DEFINITIONS 

Arguments within a macro definition or macro call are separated from other arguments 
by any of the separating characters described in Section 6-3.1.1. 
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For example: 

.MACRO REN A,B,C 

REN ALPHA, BETA, <C1,C2> 

Arguments that contain separating characters are enclosed in paired angle brackets. 
An up-arrow construction is provided to allow angle brackets to be passed as 
arguments. Bracketed arguments are seldom used in a macro definition, but are more 
likely in a macro call. For example: 

REN <MOV X,Y>,#44,WEV 

This call would cause the entire statement 

MOV X,Y 

to replace all occurrences of the symbol A in the macro definition. Real arguments 
within a macro call are considered to be character strings and are treated as a 
single entity until their use in the macro expansion. 

The up-arrow construction could have been used in the above macro call as shown here. 

REN t/MOV X,Y/,#44,WEV 
is equivalent to 

REN <MOV X,Y>,#44,WEV . 

Since spaces are ignored preceding an argument, they can be used to increase 
legibility of bracketed constructions. 

The form 

REN #44,WEVVMOV X,Y/ 

however, contains only two arguments, #44 and WEV+/MOV X,Y/ (see Section 6-3.1.1), 
because t is a unary operator. 

6.3.1 Macro Nesting 

Macro nesting (nested macro calls) , where the expansion of one macro includes a call 
to another macro, causes one set of angle brackets to be removed from an argument 
with each nesting level. The depth of nesting allowed is dependent upon the amount 
of core space used by the program being assembled. To pass an argument containing 
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legal argument delimiters to nested macros, the argument should be enclosed in one 
set of angle brackets for each level of nesting, as shown below. 

1 

2 
d 

4 
3 
6 
7 

8 

9 .MACRO LEVEL, F00,F0Q2 

itf LEVEL1 F00 

U LEVEL1 F002 

12 .ENOM 

13 

14 .MACRO LEVfcLl,F003 

15 F003 

16 ADD #10, H0 JAQJUST TABLE POINTER 

17 MOV R0,-lSP) JSAVE IT FOR LATER 
19 .E'NOM 

19 

2« 00076 LEVEL <<M0V RT0, R0»><<CLR Rl»» 

00076 LEVELi <M0V *T0,R0> 

000/6 016700 MOV RT0,H0 

177764 
001*2 W62/00 ADO #10, Kf) fADJUST TAbUE POINTER 

(300010 
00106 (010M6 MOV R0,-CSP) JSAVE IT FOR LATER 

0MU0 LEVEL! <CLR «1> 

00110 005001 CLR Rt 

00112 062700 AOQ #10, R0 JA0JU3T TABLE POINTER 

1300010 
00116 01U046 MOV R0,-CSP) ;SAVE IT FOR LATER 

21 



Where macro definitions are nested (that is, a macro definition is entirely con- 
tained within the definition of another macro) , the inner definition is not defined 
as a callable macro until the outer macro has been called and expanded. For example: 

.MACRO LV1 A,B 



.MACRO LV2 A 



.ENDM 
.ENDM 

The LV2 macro cannot be called by name until after the first call to the LVl macro, 
Likewise, any macro defined within the LV2 macro definition cannot be referenced 
directly until LV2 has been called. 
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6.3.2 Concatenation 

The apostrophe or single quote character ( ' ) operates as a legal separating char- 
acter in macro definitions. An ' character that precedes and/or follows a dummy 
argument in a macro definition is removed, and the substitution of the real argument 
occurs at that point. For example: 



1 

2 










3 










4 










5 










6 










7 






•MACRO 


DEF,i,J,K 


8 




HT»J? 


•ASCIZ 


/*/ 


9 






.EVEN 




10 






.XORD 


'I 


11 






.ENOM 




12 










16 00142 






DEF 


RT5,6,<MACR0-U> 


130142 


115 


RT&J 


•ASCIZ 


/MACHQ-.H/ 


tf*)l 4 3 


101 








0W144 


103 








001*5 


122 








00146 


117 








001*7 


«SS 








(40130 


061 








00151 


06l 








00132 


000 




• EVEN 




0W1S4 


1380000(3 




,wORO 


RT5 



Within nested macro definitions, multiple single quotes can be used, with one quote 
removed at each level of macro nesting. 

6.3.3 Special Characters 

Arguments may include special characters without enclosing the argument in a bracket 
construction, if that argument does not contain spaces, tabs, semicolons, or commas. 
For example: 

.MACRO PUSH ARG 
MOV ARG,-(SP) 
• ENDM 



PUSH X+3(%2) 
generates the following code: 

MOV X+3(%2) ,-(SP) 
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6.3.4 Numeric Arguments Passed as Symbols 

When passing macro arguments, a useful capability is to pass a symbol that can be 
treated by the macro as a numeric string. An argument preceded by the unary 
operator backslash (\) is treated as a number in the current radix. The ASCII 
characters representing the number are inserted in the macro expansion; their 
function is defined in context. For example: 



1 

2 












3 












4 












5 












6 












7 




000004 




NUHM 




8 




000000 




C0U*(d 




9 








,MAC«0 


INK,V1,V2 


10 








COUNT 


V1,0V2 


11 








C0U«C0U 


♦ 1 


12 








• ENQM 




13 
14 








.MACHO 


COUNT, VlrV2 


Id 






RT'Vl t 


,W0*D 


V2 


16 








• ENQM 




17 












19 


mi'*® 






JINK 


<10>»NUM 




tftfl20 






COUNT 


10 r ONUM 




tf»l20 


WV30004 


RTlM! 


• WORD 


4 






000001 




C0U»C0U+1 



Using this facility can make source listings somewhat clearer. For example, 
versions of programs created through conditional assembly of a single source can 
identify themselves as follows. 



.MACRO IDT SYM 

.IDENT /SYM/ 

.ENDM 

.MACRO OUT ARG 

IDT 005A*ARG 

.ENDM 



ASSUME THAT THE SYMBOL ID TAKES 
ON A UNIQUE 2-DIGIT VALUE FOR 
EACH POSSIBLE CONDITIONAL ASSEMBLY 
OF THE PROGRAM 



OUT 



\ID 



WHERE 005A IS THE UPDATE 
VERSION OF THE PROGRAM 
AND ARG INDICATES THE 
CONDITIONAL ASSEMBLY VERSION. 



The above macro call expands to 

.IDENT /005AXX/ 
where XX is the conditional value of ID. 
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Two macros are necessary since the text delimiting characters in the .IDENT state- 
ment would inhibit the concatenation of a dummy argument. 

6.3.5 Number of Arguments 

If more arguments appear in the macro call than in the macro definition, the excess 
arguments are ignored. If fewer arguments appear in the macro call than in the 
definition, missing arguments are assumed to be null (consist of no characters). 
The conditional directives .IF B and .IF NB can be used within the macro to detect 
unnecessary arguments. 

A macro can be defined with no arguments. 

6.3.6 Automatically Created Symbols 

MACRO can create symbols of the form n$ where n is a decimal integer number such 
that 64<n<127. Created symbols are always local symbols between 64$ and 127$. 
(For a description of local symbols, see Section 6-3.7.) Such local symbols are 
created by the assembler in numerical order. 

64$ 
65$ 



126$ 
127$ 

Created symbols are particularly useful where a label is required in the expanded 
macro. Such a label must otherwise be explicitly stated as an argument with each 
macro call or the same label is generated with each expansion and results in a 
multi-defined label. Unless a label is referenced from outside the macro, there is 
no reason for the programmer to be concerned with that label. 

The range of these local symbols extends between two explicit labels. Each new 
explicit label creates a new local symbol block. 

The macro processor creates a local symbol on each call of a macro whose definition 
contains a dummy argument preceded by the ? (question mark) character. Local 
symbols are generated only where the real argument of the macro call is either null 
or missing. If a real argument is specified in the macro call, the generation of 
a local symbol is inhibited and normal replacement is performed. Consider the 
following example and expansions. 
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i 

2 












3 












4 


\ 










5 












6 












7 








•MACRO 


TESTER 


« 








TST 


REG 


9 








b£Q 


LAB 


10 








ADD 


*5,REG 


n 






lAbi 






IS 








,ENOM 




13 












14 


00122 






TEST 


%1 




00122 


005/01 




TST 


XI 




0^124 


001402 




BEU 


64$ 




00126 


002701 
000005 




AOU 


#5,%1 




00132 




G4$S 






15 


00132 






TEST 


XliXYZ 




00132 


005701 




1ST 


XI 




00134 


001402 




BEQ 


XY* 




(50136 


062701 

000005 




AOO 


*5,%1 




00142 




XY2? 







These assembler-generated symbols are restricted to the first 16 (decimal) arguments 
of a macro definition. 

6.4 .NARG, .NCHR, AND .NTYPE 

These three directives allow the user to obtain the number of arguments in a macro 
call (.NARG), the number of characters in an argument (.NCHR), or the addressing 
mode of an argument (.NTYPE). Use of these directives permits selective modifica- 
tions of a macro depending upon the nature of the arguments passed. 

The .NARG directive enables the macro being expanded to determine the number of 
arguments supplied in the macro call. 

Format : 

[label:] .NARG symbol 

where 

label is an optional statement label. 

symbol is any legal symbol whose value is to be equated to the number of 
arguments in the macro call currently being expanded. The symbol 
can be used by itself or in expressions. 

The .NARG directive can occur only within a macro definition. 
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s 




.MACRO 


NOPPfNUM 


6 




• NARG 


SYM 


7 




• IF 


EU,SYM 


8 




,MEXIT 




9 




• IFF 




10 




.KEPT 


NUM 


11 




NOP 




12 




.ENQtf 




13 




• £NOC 




14 




• ENQM 




15 








16 00202 




NOPP 






1000000 


»NA^(i 


SYM 






• IF 


ea,stM 






•MfcXIT 








.IFF 








• KEPT 








NOP 








• ENQM 








,ENOC 




17 








19 W0202 




NQPP 


6 




000001 


.NA«G 


SYM 






• IF 


eq,sym 






.MEXIT 








• IFF 






000006 


• HEPT 

NOP 

.ENQM 


6 


00202 


0002410 


NOP 




00204 


00024 


NOP 




0i«206 


000240 


NOP 




00210 


V 00240 


NOP 




0(4212 


000240 


NOP 




00214 


000240 


NOP 
• ENOC 





The .NCHR directive enables a program to determine the number of characters in a 
character string. 

Format: 

[label:] .NCHR symbol, <character string> 



where 



label is an optional statement label. 

symbol is any legal symbol that is to be equated to the number 

of characters in the specified character string. The 
symbol is separated from the character string argument 
by any legal separator. 
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<character string> is a string of printing characters that should only be 

enclosed in angle brackets if it contains a legal 

separator. A semicolon also terminates the character 
string. 

The .NCHR directive can occur anywhere in a MACRO program. 



1 
2 
3 
4 
5 
« 
7 

a 

9 

n 

12 

13 001/2 

0(0 1/2 d00.W05 
MM 174 110 
001/5 iwS 



.MACRO 


CHAR* MESS 


• NCHH 


SYM,MESS 


• «0Rl) 


SYM 


• A3CU 


/MESS/ 


.ENl)M 




CHAR 


<HELL0> 


• NCHH 


SYM, HELLO 


• WUtfD 


SYM 


•ASCII 


/HELLO/ 



tfv5J/6 HA 

m\77 114 

M0200 it? 
14 .EVEN 



The .NTYPE directive enables the macro being expanded to determine the addressing 
mode of any argument.. 

Format: 

[label:] .NTYPE symbol, arg 

where 

label is an optional statement label. 

symbol is any legal symbol, the value of which is to be equated to the 
6-bit addressing mode of the argument. The symbol is separated 
from the argument by a legal separator. This symbol can be used 
by itself or in expressions. 

arg is any legal macro argument (dummy argument) as defined in Section 
6-6.3. 

The .NTYPE directive can occur only within a macro definition. 
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1 

2 
3 
4 
5 
6 
7 






•MACRO 


3AVE,ARG 




8 






•NTYPE 


3YM,ARG 




9 






• IP 


EO,3YM&70 




10 






MOV 


ARG,TEMP 


^REGISTER MODE 


11 






• IFF 






12 






MOV 


#ARG,TEMP 


7NON-REGISTER MODE 


13 






• ENOC 






14 






• ENOM 






IS 












16 


00156 


000000 TEMP* 


• WORD 







17 












18 


00160 




SAVE 


XI 








000001 


•NTYPE 
• IF 


SY'M,Xl 
£Q,5YM*70 






001b0 


010167 


MOV 


XI, TEMP >R£G'iaTER MODE 






177/72 


• IFF 


* . 










MOV 


*%lt TEMP 


?N0N-REGISTER MODE 








• ENQC 






la 












20 


00164 




SAVE 


TEMP 








000067 


•NTYPE 
• IF 


SYM,TEMP 
EQ,SYM&70 










MOV 


TEMP, TEMP 


^REGISTER MODE 








• IFF 








00164 


012/67 

0001561 

177764 


MOV 


#TEMP f TfcMP 


rNON-REOlSTER MODE 



• ENOC 



6.5 .ERROR AND .PRINT 

The .ERROR directive is used to output messages to the command output device during 
assembly pass 2. A common use is to provide diagnostic announcements of a rejected 
or erroneous macro call. The form of the .ERROR directive is as follows: 

[label:] .ERROR [exprj ;text 

where 

label is an optional statement label. 

expr is an optional legal expression whose value is output to the 

command device when the .ERROR directive is encountered. Where 
expr is not specified, the text only is output to the command 
device . 

; denotes the beginning of the text string to be output. 

text is the one-line string to be output to the command device. 
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Upon encountering an .ERROR directive anywhere in a MACRO program,, the assembler 
outputs a single line containing the following information. 

1. The sequence number of the .ERROR directive line. 

2. The current value of the location counter. 

3. The value of the expression if one is specified. 

4. The text string specified. 

For example, 

.ERROR A /UNACCEPTABLE MACRO ARGUMENT 
causes a line similar to the following to be output: 

512 5642 000076 ; UNACCEPTABLE .MACRO ARGUMENT 

where the above fields are, from left to right, sequence number, location counter, 
expression value, and text. 

The line is flagged on the assembly listing with a P error code. 

The .PRINT directive is identical to .ERROR except that it is not flagged with a P 
error code , 

6.6 INDEFINITE REPEAT BLOCK: .IRP AND .IRPC 

An indefinite repeat block is a structure very similar to a macro definition. An 
indefinite repeat is essentially a macro definition that has only one dummy 
argument and is expanded once for every real argument supplied. An indefinite 
repeat block is coded in line with its expansion, rather than being referenced by 
name as a macro is referenced. 

An indefinite repeat block can occur either within or outside macro definitions, 
repeat ranges, or indefinite repeat ranges. The rules for creating an indefinite 
repeat block are the same as for the creation of a macro definition. Indefinite 
repeat arguments follow the same rules that apply to macro arguments. 

Format: 

[label:] .IRP arg,<real arguments> 

(range of the indefinite repeat) 



.ENDM 
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where 



label 



arg 



<real arguments 



range 



is an optional statement label. A label may not appear on 
any .IRP statement within another macro definition, repeat 
range or indefinite repeat range, or on any .ENDM statement, 

is a dummy argument that is successively replaced with the 
real arguments in the .IRP statement. 

is a list of arguments to be used in the expansion of the 
indefinite repeat range and enclosed in angle brackets. 
Each real argument is a string of zero or more characters 
or a list of real arguments (enclosed in angle brackets) . 
The real arguments are separated by commas . 

is the block of code to be repeated once for each real 
argument in the list. The range may contain macro 
definitions, repeat ranges, or other indefinite repeat 
ranges. Note that only created symbols should be used as 
labels within an indefinite repeat range . 



Figure 6-6 


illustrates the use of 


.IRP. 


1 
2 








6 








A 








5 - 








e> 








7 




,IRP 


X,«A»9,C» 


a 




MOV 


X, CR0) + 


9 




• ENQM 




000216 


016720 
177556 


MOV 


A»C«0)+ 


00W222 


016720 
177554 


HOV 


B, (R0) + 


000226 


016720 
177552 


NOV 


C, t«0)+ 


- 






Figure 6-6 
.IRP Example 



A second type of indefinite repeat block is available which handles character sub- 
stitution rather than argument substitution. The .IRPC directive is used as follows: 



label ; 



.IRPC arg, string 



(range of indefinite repeat) 



.ENDM 



On each iteration of the indefinite repeat range, the dummy argument (arg) assumes 
the value of each successive character in the string. 
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6.7 REPEAT BLOCK: .REPT 

Occasionally it is useful to duplicate the same block of code a number of times in 
line with other source code. This is performed by creating a repeat block of the 
following form. 

[.label:] .REPT expr 



(range of repeat block) 



.ENDM ;0R .ENDR 



where 



label is an optional statement label. The .ENDR or .ENDM directive may 
not have a label. A .REPT statement occurring within another 
repeat block, indefinite repeat block, or macro definition may 
not have a label associated with it. 

expr is any legal expression controlling the number of times the block 

of code is assembled. When the value of expr = f the range of the 
repeat block is not assembled. 

range is the block of code to be repeated expr number of times. The 
range may contain macro definitions, conditionals, indefinite 
repeat ranges or other repeat ranges. Note that no statements 
within a repeat range can have a label. 

The last statement in a repeat block can be an .ENDM or .ENDR statement. The .ENDR 
statement is provided for compatibility with previous assemblers. 

The .MEXIT statement is also legal within the range of a repeat block. 

1 

2 

A 

A 

5 

6 

/ 000020 

8 

9 

0002<*2 0140000 

000244 000000 

000246 000000 

000240 000000 

000242 000000 

000244 000000 

000246 000000 

000250 00^000 

000252 000030. 
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.REPT 


20 


• rtOHO 





■ ENOM 




,*UrtU 





,Wtl*0 





• *0£D 





,*0HD 





,*0«Q 





• WOHO 





.WUHD 





,W0RU 





• HURO 






090294 


4400000 


.WORD 





000256 


000000 


.WORD 





0002O0 


000000 


• *o*u 





000262 


000000 


.WUHQ 





000204. 


000000 


,WORO 





000206 


000000 


,wQ«D 





000270 


000000 


.WURD 





10 


000001 ' 


• ENQ 





6.8 MACRO LIBRARIES: .MCALL 

All macro definitions must occur prior to their being referenced within the user 
program. MACRO provides a selection mechanism for the programmer to indicate in 
advance those system macro definitions required by his program. 

The .MCALL directive is used to specify the names of all system macro definitions 
not defined in the current program but required by the program. The .MCALL 
directive must appear before the first occurrence of a macro call for an externally 
defined macro. The .MCALL directive has the following format, 

.MCALL argl [, arg2 , . . „ ] 

where argl,arg2, . . . are the names of the macro definitions required in the current 
program . 

When this directive is encountered, MACRO searches the system library SYSMAC.SML 
to find the requested definition (s) . 
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PART 6 

CHAPTER 7 

OPERATING PROCEDURES 

The MACRO Assembler assembles one or more ASCII source files containing MACRO 
statements. Its output consists of a relocatable binary object file and an assembly 
listing followed by the symbol table listing. A cross-reference listing (CREF) can 
be specified as part of the assembly output by means of a switch option. 

,7.1 LOADING MACRO 

MACRO is loaded with the Disk Monitor RUN command. 

$RUN MACRO 

(Characters printed by the system are underlined to differentiate them from char- 
acters typed by the user.) The assembler responds by identifying itself and its 
version number, followed by a # character to indicate readiness to accept a command 
input string, 

MACRO Vxxx 
# 

7.2 COMMAND INPUT STRING 

In response to the # printed by the assembler, the user types the output file 
specification (s) , a left angle bracket, and the input file specification (s) . 

Format : 

#ob j ect , listing<sourcel , source2 , . . . , sourceN 

where 

object is the binary object file. 

listing is the assembly listing file containing the assembly 

listing and symbol table. Optionally, a separate CRF 
listing file can be appended to the assembly listing or 
output as a separate file. 

sourcel,source2, are the ASCII source files containing the MACRO source 
..., sourceN program (s) . No limit is set on the number of input source 

files, but the assembler is limited by the size of the 

user-defined and macro symbol tables. 
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A null specification in any of the file fields signifies that the associated input 
or output file is not desired. Each file specification contains the following in- 
formation and follows the standard DOS conventions for file specifications. 

dev: filnam. ext [uic] /option :arg 

One or more switch options can be specified with each file specification to provide 
the assembler with information about that file. The switch options are described 
in Appendix J. 

A syntactical error detected in the command string causes the assembler to output 
the command string up to and including the point where the error was detected, 
followed by a ? character. The assembler then reprints the # character and waits 
for a new command string to be entered. The following command string errors are 
detected. 



Error 

Illegal switch 
Too many switches 
Illegal switch value 
Too many switch values 

Too many output file specifications 

No input file specification 



Error Message 
ILLEGAL SWITCH 

TOO MANY OUTPUT FILES 
INPUT FILE MISSING 



The default value for each file specification is noted below in Table 6-15. 



Table 6-15 
File Specification Default Values 





dev 


filnam 


ext 


uic 


object 


system 
device 


last source 
file name 


.OBJ 


current 


listing 


device used 
for object 
output 


last source 
file name 


.LST 


current 


CREF 


system 


last source 


.CRF 


current 


intermediate 


device 


file name 






sourcel 


system 


- 


.MAC 






device 




.PAL 
.null 


current 


source 2 


device used 


_ 


.MAC 




. 


for sourcel 




.PAL 


current 


. 


(last source 




.null 




sourceN 


file specified) 









(continued on next page 
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Table 6-15 (Cont.) 
File Specification Default Values 





dev 


filnam 


ext 


uic 


system 
macro 

file 


system 
device 


SYSMAC 


.SML 


current 
[1,1] 



7.3 CROSS-REFERENCE TABLE GENERATION 

A cross-reference listing (CREF) of all or a subset of all symbols used in the 
source program can be obtained by a call to the CREF routine. CREF can be used in 
two ways. 

a. CREF can be called automatically following an assembly. In order to do 
this, the /CRF switch is specified following the assembly listing file 
specification. For example: 

#_,LP:/CRF<FILEl,FILE2 

This command string sends the assembly listing (FILE2.LST) to the line 
printer. An intermediate CREF file is created and temporarily stored on 
the system device (FILE2.CRF) under the current UIC. The CREF routine 
takes this intermediate file, generates a CREF listing and routes that 
listing to the line printer. (The CREF listing is appended to the file 
FILE2.LST.) The CREF intermediate file is then deleted; there is no way 
to preserve this file when CREF is being called automatically. 

b. If- no CREF listing is desired immediately, the intermediate CREF file 
can be saved on the system device? the CREF listing can be generated at 
a later date. In order to preserve the intermediate CREF file, the 
following MACRO command string is given. 

# , LP :/CRF :NG<FILE1 ,FILE2 

This command string sends the assembly listing (FILE2.LST) to the line 
printer. The CREF intermediate file (FILE2.CRF) is sent to the system 
device under the current UIC. (The :NG argument is a mnemonic for 
"No Go" to CREF; i.e., no automatic transfer to the CREF routine 
following the output of the assembly listing.) 

In order to generate the CREF listing, the CREF routine is run and given 
a command string indicating the input file specification (s) and a single 
output file specification. For example: 

$RU 

CREF V001A 

#LP:<FILE2.CRF 

In this case the intermediate file created automatically in the MACRO example 
above is processed to obtain a CREF listing, which is then sent to the 
line printer. The CREF intermediate file is then automatically deleted. 
If it is desired to preserve the intermediate file, the following command 
string should be given. 

#LP:<FILE2.CRF/SA 
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Unless the /SA switch is specified, the default case is always to delete 
the CREF intermediate file. 

The CKEF listing is organized into one to five sections, each listing a different 
type of symbol. The sections follow here. 



Section Type 


Argument 


user-defined symbols 


:S 


macro symbolic names 


:M 


permanent symbols (instructions, 


:P 


directives) 




.PSECT symbolic names 


:C 


error codes 


:E 



Where no arguments are specified following the /CRF switch, all of the above sections 
except the permanent symbols are cross-referenced. However, if any one argument is 
specified (other than :NG) , then no other default sections are assumed or provided. 
For example, in order to obtain a CREF listing for all five section types, the 
following switch option specification is used. 

/CRF:S:M:P:C:E 

The order in which the arguments are specified does not affect the order of their 
output, as is listed above. 

Figure 6-7 contains a segment of source code and Figure 6-8 contains a segment of a 
CREF listing with some references to the code in Figure 6-7. 

In a CREF listing, each cross-referenced symbol is printed in the left-hand column, 
followed by a list of the page-line numbers of the places at which that symbol is 
referenced. A # character following a page-line number indicates the point at 
which the listed symbol is defined. An @ character designates a page-line number 
at which the contents of that symbol are possibly altered. 
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1 

2 

3 012026 

4 012026 
012026 004767 

174240 

5 012032 005767 



6 012036 

7 012040 

8 012040 

9 012044 

10 12046 



ENDP: 



.SBTTL OBJECT CODE HANDLERS 

;END OF PASS HANDLER 



11 12054 
12054 

12 12060 

13 12064 

14 12070 
12070 

15 12074 

16 12076 

17 12102 
12102 

12106 

18 12112 

19 12114 

20 12120 

21 12124 

22 12126 

23 12132 

24 12134 

25 12140 

26 12144 

27 12146 

28 12150 

29 12152 

30 12156 

31 12162 
12162 



001142 

005767 

001416' 

001517 

012767 

000001 

000542 ' 

004767 

001542 

012701 

000050' 

016702 

000540' 

004767 
000660 
005046 
012667 10$: 
000006 * 

012700 

000010 

004767 

005400 

001450 

016746 

000006' 

012701 

000006 ' 

011105 

042705 

000377 

000305 

042711 

177737 

052721 

000410 

010521 

001401 

011141 

005067 

000006 ' 

012701 

000002 ' 



11$: 



12$: 



004767 
00056 



CALL 
JSR 

TST 



SETMAX 
PCSETMAX 

PASS 



BNE ENDP 2 

ENTOVR 4 

TST OBJLNK 



BEQ 
MOV 



CALL 
JSR 

MOV 

MOV 

CALL 
JSR 

CLR 
MOV 

NEXT 
MOV 

JSR 

BEQ 
MOV 

MOV 

MOV 
BIC 

SWAB 
BIC 

BIS 



30$ 
#BLKT01,BLKTYP 



OBJINI 
PC f OBJINI 

#PRGTTL,Rl 

RLDPNT,R2 

GSDDMP 
PC f GSDDMP 

-<SP) 

(SP)+, ROLUPD 

SECROL 
#SECROL,R0 

PC, NEXT 

20$ 

ROLUPD, -(SP) 

#MODE,Rl 

(Rl) f R5 
#377, R5 

R5 



;PASS ONE? 

; BRANCH IF PASS 2 

;PASS ONE, ANY OBJECT? 

; NO 

;SET BLOCK TYP1 1 

;INIT THE POINTERS 

fSET "FROM" INDEX 
; AND "TO" INDEX 
; OUTPUT GSD BLOCK 



;INIT FOR SECTOR SCAN 
;SET SCAN MARKER 

;GET THE NEXT SECTOR 



; BRANCH IF THROUGH 
;SAVE MARKER 



;SAVE SECTOR 
; ISOLATE IT 

; AND PLACE IN RIGHT 
; CLEAR ALL BUT REL BIT 



#-l-<RELFLG>,(Rl) 

#<GSDT01>+DEFFLG. (Rl)+ ;SET TO TYPE 1, DEFINED 



ASSURE ABS 

OOPS! 

REL, SET MAX 
SET FOR INNER SCAN 



MOV 
BEQ 
MOV 
CLR 


R5, (Rl)+ 
11$ 

(R1),-(R1) 
ROLUPD 


MOV 


#SYMBOL,Rl 


CALL 
JSR 


GSDDMP 
PC, GSDDMP 




Figure 6-7 
Assembly Listing 



; OUTPUT THIS BLOCK 
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32 12166 13$ 


: NEXT 


SYMBOL 


; FETCH THE NEXT SYMBOL 


12166 012700 


MOV 


#SYMBOL.R0 




000000 








12172 004767 


JSR 


PC, NEXT 




005314 








33 12176 001737 


BEQ 


10$ 


; FINISHED WITH THIS GUY 


34 12200 032767 


BIT 


#GLBFLG,MODE 


; GLOBAL? 


000100 








000006' 








35 12206 001767 


BEQ 


13$ 


; NO „ 


36 12210 126705 


CMPB 


SECTOR, R5 


;YES, PROPER SECTOR? 


000007' 








37 12214 001364 


BNE 


13$ 


; NO 


38 12216 042767 


BIC 


#-l-<DEFFLG!RELFLG!GLBFLG>,MODE ; CLEAR MOST 


177627 








000006 ' 








39 12224 052767 


BIS 


#GSDT04,MODE 


•SET TYPE 4 


002000 








000006 ' 








40 12232 000751 


BR 


12$ 


; OUTPUT IT 



Figure 6-7 (cont.) 
Assembly Listing 



ENDMAC 


27-40 


109-33# 


ENDP 


23-23 


72- 3# 


ENDP1M 


73-16 


72-22# 


ENDP2 


72- 6 


74- 1# 



MDFFLG 


12- 7# 


35-28 


92- 8 


92-24 








MEXIT 


116- 1# 


116-41# 












MODE 


14- 6# 


22-290 


34-12 


35-17(9 


36-12 


37- 4 


40-43 




45- 6@ 


48-160 


58-38(9 


64-23 


70-10 


72-20 


72-34 




72-380 


72-390 


74-34 


75-37 


86- 8 


91-200 


106-27 




116-34# 














MOVBYT 


18- 5 


18- 9 


28-44 


74-41 


83-11 


83-20 


108-19 


MPDP 


109-42 


121-17# 












MPUSH 


109-26 


110-48 


121- 1# 










MSBARG 


27- 9 


121-18 


121-40# 










MSBBLK 


121- 4 


121-28 


' 121-36# 










MSBCNT 


27-15 


109-33 


116- 6 


121-41# 








MSBEND 


121- 9 


121-28 


121-43# 










MSBMRP 


25-19 


27-250 


110-490 


121-42# 









Figure 6-8 
Excerpts from CREF Listing to Accompany Figure 6-7 

Note particularly the CREF references for ENDP, 
ENDP 2, and MODE. 
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PART 6 

CHAPTER 8 

A SUMMARY OF THE MACRO 
ASSEMBLY LANGUAGE AND ASSEMBLER 



8.1 SPECIAL CHARACTERS 
Character 
vertical tab 



% 
tab 



space , 

# 
§ 
( 
) 
, (comma) 

7 

+ 



* 

7 

& 

i 
ii 

' (apostrophe) 

< 
> 



Function 

Source line terminator 

Label terminator 

Direct assignment indicator 

Register term indicator 

Item terminator 

Field terminator 

Item terminator 

Field terminator 

Immediate expression indicator 

Deferred addressing indicator 

Initial register indicator 

Terminal register indicator 

Operand field separator 

Comment field indicator 

Arithmetic addition operator or auto 

increment indicator 

Arithmetic subtraction operator or auto 

decrement indicator 

Arithmetic multiplication operator 

Arithmetic division operator 

Logical AND operator 

Logical OR operator 

Double ASCII character indicator 

Single ASCII character indicator 

Assembly location counter 

Initial argument indicator 

Terminal argument indicator 

Universal unary operator 

Argument indicator 

MACRO numeric argument indicator 

Global label terminator 

Global assignment indicator 
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8.2 ADDRESS MODE SYNTAX 

n is an integer between and 7 representing a register. R is a register expression, 
E is an expression, ER is either a register expression or an expression in the range 
to 7. 



Format 


Address 

Mode 

Name 


Address 

Mode 

Number 


Meaning 


R 


register 


0n 


Register R contains the operand. R is 
a register expression. 


@R or 
(ER) 


deferred register 


In 


Register R contains the operand address. 


(ERR 


autoincrement 


2n 


The contents of the register specified 
by ER are incremented after being used 
as the address of the operand. 


@ (ER) + 


deferred auto- 
increment 


3n 


ER contains the pointer to the address 
of the operand. ER is incremented 
after use. 


-(ER) 


autodecrement 


4n 


The contents of register ER are 
decremented before being used as the 
address of the operand. 


@- (ER) 


deferred auto- 
decrement 


5n 


The contents of register ER are 
decremented before being used as the 
pointer to the address of the operand. 


E(ER) 


index 


6n 


E plus the contents of the register 
specified, ER, is the address of the 
operand . 


@E (ER) 


deferred index 


7n 


E plus the contents of the register 
specified, ER, is the address of the 
address of the operand. 


#E 


immediate 


27 


E is the operand. 


@#E 


absolute 


37 


E is the address of the operand. 


E 


relative 


67 


E is the address of the operand. 


@E 


deferred relative 


77 


E is the pointer to the address of 
the operand. 
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8.3 ASSEMBLER DIRECTIVES 





Described 




Form 


In Section 


Operation 


■ 


6-5.3.3 


A single quote character (apostrophe) 
followed by one ASCII character generates 
a word contains the 7-bit ASCII represen- 
tation of the character in the low-order 
byte, and zero in the high-order byte. 




6-6.3.2 


Concatenation within a macro. 


it 


6-5.3.3 


A double quote character followed by two 
ASCII characters generates a word con- 
taining the 7 -bit ASCII representation 
of the two characters. 


+Bn 


6-5.4.2 


Temporary radix control; causes the number 
n to be treated as a binary number . 


tCn 


6-5.6.2 


Creates a word containing the one's com- 
plement of n. 


+Dn 


6-5.4.2 


Temporary radix control; causes the number 
n to be treated as a decimal number. 


+Fn 


6-5.6.2 


Creates a one-word floating point quantity 
to represent n. 


+0n 


6-5.4.2 


Temporary radix control; causes the number 
n to be treated as an octal number. 


.ASCII string 


6-5.3.4 


Generates a block of data containing the 
ASCII equivalent of the character string 
(enclosed in delimiting characters) one 
character per byte. 


.ASCIZ string 


6-5.3.5 


Generates a block of data containing the 
ASCII equivalent of the character string 
(enclosed in delimiting characters) , one 
character per byte with a zero byte 
following the specified string. 


.ASECT 


6-5.9.2 


Begin or resume absolute section. 


.BLKB exp 


6-5.5.3 


Reserves a block of storage space exp 
bytes long. 


.BLKW exp. 


6-5.5.3 


Reserves a block of storage . space exp 
words long. 


. BYTE expl , exp2 , . . . 


6-5.3.1 


Generates successive bytes of data con- 
taining the octal equivalent of the 
expression (s) specified. 


.CSECT symbol 


6-5.9.2 


Begin or resume named or unnamed reloca- 
table section. 



(continued on next page) 
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Form 


Described 






In Section 


Operation 


.DSABL arg 


6-5.2 


Disables the assembler function specified 
by the argument. 


•ENABL arg 


6-5.2 


Provides the assembler function specified 
by the argument. 


.END 


6-5.7.1 


Indicates the physical end of source pro- 


.END exp 




gram. An optional argument specifies the 






transfer address. 


• ENDC 


6-5.11 


Indicates the end of a conditional block. 


.ENDM 


6-6.1.2 


Indicates the end of the current repeat 


.ENDM symbol 




block, indefinite repeat block, or macro. 
The optional symbol, if used, must be 
identical to the macro name. 


.EOT 


6-5.7.2 


Ignored. Indicates end -of -tape, which is 
detected automatically by the hardware. 


.ERROR exp, string 


6-6.5 


Causes a text string containing the 
optional expression and the indicated text 
string to be output to the command device. 


.EVEN 


6-5.5.1 


Ensures that the assembly location counter 
contains an even address by adding 1 if it 
is odd. 


.FLT2 argl,arg2,. .. 


6-5.6.1 


Generates successive two-word floating- 
point equivalents for the floating-point 
numbers specified as arguments. 


.FLT4 argl,arg2, ... 


6-5.6.1 


Generates successive four-word floating- 
point equivalents for the floating-point 
numbers specified as arguments. 


.GLOBL syml , sym2 , . . . 


6-5.10 


Defines the symbol (s) specified as global 
symbol (s). 


.IDENT symbol 


6-5.1.5 


Provides a means of labeling the object 
module with the program version number . 
The symbol is the version number between 
paired delimiting characters. 


.IF cond,argl f arg2, . . . 


6-5.11 


Begins a conditional block of source code, 
which is included in the assembly only if 
the stated condition is met with respect 
to the argument (s) specified. 


• IFF 


6-5.11.1 


Appears only within a conditional block 
and indicates the beginning of a section 
of code to be assembled if the condition 
tested false. 



(continued on next page) 
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Form 


Described 






In Section 


Operation 


.IFT 


6-5.11.1 


Appears only within a conditional block 
and indicates the beginning of a section 
of code to be assembled if the condition 
tested true. 


.IFTF 


6-5.11.1 


Appears only within a conditional block 
and indicates the beginning of a section 
of code to be unconditionally assembled. 


.IIF cond, arg, statement 


6-5.11.2 


Acts as a one-line conditional block 
where the condition is tested for the 
argument specified. The statement is 
assembled only if the condition tests 
true . 


.IRP sym,<argl,arg2, .. .> 


6-6.6 


Indicates the beginning of an indefinite 
repeat block in which the symbol specified 
is replaced with successive elements of 
the real argument list (which is enclosed 
in angle brackets) . 


.IRPC sym, string 


6-6.6 


Indicates the beginning of an indefinite 
repeat block in which the symbol specified 
takes on the value of successive characters 
in the character string. 


.LIMIT 


6-5.8 


Reserves two words into which the Linker 
inserts the low and high addresses of the 
relocated code. 


.LIST 


6-5.1.1 


Without an argument, .LIST increments the 


.LIST arg 




listing level count by 1. With an 
argument, .LIST does not alter the listing 
level count but formats the assembly 
listing according to the argument speci- 
fied. 


. MACRO sym , ar gl , ar g2 , . . . 


6-6.1.1 


Indicates the start of a macro named sym 
containing the dummy arguments specified. 


.MEXIT 


6-6.1.3 


Causes an exit from the current macro or 
indefinite repeat block. 


.NARG symbol 


6-6.4 


Appears only within a macro definition and 
equates the specified symbol to the number 
of arguments in the macro call currently 
being expanded. 


.NCHR sym, string 


6-6.4 


Can appear anywhere in a source program; 
equates the symbol specified to the number 
of characters in the string (enclosed in 
delimiting characters) . 


.NLIST 


6-5.1.1 


Without an argument, .NLIST decrements the 


.NLIST arg 




listing level count by 1. With an argu- 
ment, .NLIST deletes the portion of the 
listing indicated by the argument. 



(continued on next page) 
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Described 




Form 


In Section 


Operation 


.NTYPE sym,arg 


6-6.4 


Appears only in a macro definition and 
sets the low-order six bits of the symbol 
specified to the six-bit addressing mode 
of the argument. 


.ODD 


6-5.5.2 


Ensures that the assembly location 
counter contains an odd address by adding 
1 if it is even. 


.PAGE 


6-5.1.6 


Causes the assembly listing to skip to the 
top of the next page. 


.PSECT 


6-5.9 


Begin or resume a program section. 


.PRINT exp, string 


6-6.5 


Causes a text string to be output to the 
command device containing the optional 
expression specified and the indicated 
text string. 


.RADIX n 


6-5.4.1 


Alters the current program radix to n, 
where n can be 2, 4, 8, or 10. 


.RAD50 string 


6-5.3.6 


Generates a block of data containing the 
Radix-50 equivalent of the character 
string (enclosed in delimiting characters) , 


.REPT exp 


6-6.7 


Begins a repeat block. Causes the section 
of code up to the next .ENDM or .ENDR to 
be repeated exp times. 


.SBTTL string 


6-5.1.4 


Causes the string to be printed as part 
of the assembly listing page header. The 


- 




string part of each .SBTTL directive is 
collected into a table of contents at the 
beginning of the assembly listing. 


.TITLE string 


6-5.1.3 


Assigns the first symbolic name in the 
string to the object module and causes the 
string to appear on each page of the 
assembly listing. One .TITLE directive 
should be issued per program. 


•WORD expl , exp2 , . . . 


6-5.3.2 


Generates successive words of data con- 
taining the octal equivalent of the 
expression (s) specified. 
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PART 6 

CHAPTER 9 

PERMANENT SYMBOL TABLE 

The Permanent Symbol Table (PST) defines values for each symbol that is automati- 
cally recognized by MACRO. The symbols defined include op-codes and macro-calls. 
A listing of the Permanent Symbol Table forms the balance of this chapter. 

pfrmanfnt symbol tablf 
fguatfd symbols 

instructive reference in first field 

fOFSTRUCTIVF PEFERFNCE IN SECOND FIELD 

jDTRFCTIVF REQUIRES EVFN LOCATION 
»DIRFCTIVF USFS PYTf MODE 
^CONDITIONAL nlRFCTlVE 
»MACR0 DTRFCTTVF 
JMCALL 



DRi« 
DR2« 


200 
100 


DFLGEVa«P20 
DFLGBMa.pilfl 
DFLCNDs«004 
DFLMAr««00? 
DFLSMO..001 


1 

1 LOCAL 

* 


MACROS 


XMACROb 

X40» 

X45» 


.IF DF PALUR 


(* 



• Endc 



IPAL11R SUBSET 



f ITF DF X459&X45. XFl TG» 

.TIF DF XMACRO, XSMI « ft 



J.MA0P0 


OPCDFF NAMF, 


.IF MB 


<CONO> 


'.IF DF 


COND 


.MEW 




'.ENDC 




i.EMDC 




.RAD50 


/NAME/ 


'.BYTF 


FLAGS+0 


.BYTE 


200+OPCL • CLASS 


,W0RD 


VALUE 


.ENDM 




\ MACRO 


DIRDFF NAMF, 


.RAnsa 


/.'NAME/ 


.BYTF 


FLAGS+0. 


\\f NB 


<C0ND> 


.IF DF 


OOND 



CLASS. VALUE. FLAGS. COND 



FLAGS. COND 
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,ME*IT 

.ENDC 
.ENDC 

>ord 

.ENDM 

, MACRO 

'.BYTF 

, IF NB 

,.TF PF 

.WOPp 

'.MEVIT 

.ENDC 

[.ENDC 

.ENDM 



OPCERR 



MAME 



DIRDF1 NAME.'ENTRY. FLAGS. CONO 

/,'NAME/ 

FLAGS.PI 

<COND> 

CONO 

OPCERR 



ENTRY 



PSTBASfi 



OPCHEF 
OPCDEF 
OPCOFF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCDEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOFF 
OPCDEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCDEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCDEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOFF 
OPCOEF 
OPCDEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCOEF 
OPCDEF 



<ABSD 

<ABSF 

<AOC 

<AOCB 

<AOD 

<AODD 

<AODF 

<A3H 

<ASHC 

<ASL 

<ASLB 

<A8R 

<ASRB 

<BCC 

<8C8 

<BEQ 

<8GE 

<BGT 

<BHI 

<BHI$ 

<BIC 

<BXCB 

<BIS 

<BISB 

<BIT 

<BITB 

<BLE 

<BLO 

<BLOS 

<BLT 

<BMI 

<BNE 

<BPL 

<BPT 

<BR 

<BVC 

<BVS 

<CCC 

<CFCC 

<CLC 

<CLN 

<CLR 

<CLRB 



fRFF LABEL 






01, 


170608, 


DRl. 


X45 


01, 


170600, 


OR1. 


X45 


01, 


0055051, 


OR1 




01. 


105500, 


OR1 




02, 


0600001, 


0R2 




Hi 


17200a, 


DR2. 


X45 


Hi 


17200a, 


, 0R2. 


Y45 


09, 


, 07200a, 


, 0R2. 


X40&X45 


09, 


, 07300a, 


, 0R2. 


X40&X45 


01, 


, 006.10a, 


, DRl 




01. 


106300, 


- DRl 




01 


, 00620a 


, OR1 




01 


10620a 


, DRl 




04 


, 10300a 






04 


10340a 






04 


, 001400 






04 


, 00200a 






04 


, 003000 






04 


, 101000 






04 


, 10300a 






02 


, . 04000a, 


, 0R2 




02 


, 14000a 


, 0R2 




02 


, 05000a 


, 0R2 




02 


, 15000a 


t 0R2 




02 


, 030000 






02 


, 13030a 






04 


, 003400 






04 


, 10340a 






04 


, 10140a 






04 


, 0024aa 






04 


, 10040a 






04 


, 00100a 






04 


, 10000a, 






00 


, 000003, 


9 m 


X45 


04 


, 00040a, 






04 


, 10200a 






04 


, 102400 






00 


, 000257 






00 


, 17000a 


m 


X45 


00 


, 000241 , 






00" 


," 00025a, 






01 


,' 00500a, 


, DRl 




01 


, 10500a, 


, DRl 
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OPCHEF 


<CL»H 


> 


01 


170400 


, HR1 


X45 


OPCHEF 


<CL«F 


> 


01 


t 17040<a 


, DR1 


X45 


OPCHFF 


<CLV 


> 


, 00 


, 00024? 






OPCHEF 


<CLZ 


> 


r 00 


000244 






OPCHEF 


<CMP 


> 


, 02 


, 020000 






OPCHEF 


<CMPR 


> 


02 


, 12000a 






OPCnfF 


<cmpr 


> 


f 11 


173400 


9 


Y45 


OPCHEF 


<CMPF 


> 


, It 


173400 


1 


X45 


OPCHEF 


<CMZ 


> 


, 00 


, 000254 






OPCHEF 


<COM 


> 


, Pit 


, 00510a 


r HR1 




OPCHEF 


<COMB 


> 


, 01 


, 10510a 


, HR1. 




OPCHEF 


<OEC 


> 


, 01 


, 005300 


, HR1 




OPCHFF 


<OECR 


> 


01 


105300 


, DR1 




OPCHEF 


<OIV 


>, 


r 07, 


071000 


, DR2, 


X40&X45 


OPCHEF 


<HIVP 


> 


f 11 


17440a 


f HR2 


X45 


OPCHEF 


<DIVF 


> 


f 11 


174400 


, DR2 


X45 


OPCHEF 


<EMT 


> 


, 06 


, 10400a 






OPCHEF 


<FADH 


> 


, 03 


, 075000 


, HH1 


X40 


OPCHEF 


<FDIV 


> 


r 03 


075030 


, HR1 


X40 


OPCHEF 


<FMUL 


>, 


r 03, 


07502a, 


f 0R1, 


X40 


OPCHEF 


<FSUB 


>, 


03, 


07501a, 


HR1. 


X40 


OPCHEF 


<HALT 


>, 


00, 


00000a, 






OPCHEF 


<INC 


>, 


"ll 


, 005200, 


HR1 




OPCHEF 


<INCB 


>, 


01, 


10520a, 


DR1 




OPCHEF 


<IOT 


>, 


00, 


000004, 






OPCHEF 


<JMP 


>, 


01, 


, 00010a, 






OPCHEF 


<JSR 


>, 


05, 


, 00400a, 


, HR1 




OPCHEF 


<LOCDF 


>, 


U, 


17740a, 


DR2, 


X45 


OPCHEF 


<LOCFD 


>, 


11. 


17740a, 


HR2, 


X45 


OPCHEF 


<L0CTD 


>, 


14, 


17700a, 


, HR2, 


X45 


OPCHEF 


<UHCTF 


>, 


14, 


17700a, 


HR2, 


X45 


OPCHEF 


<LDCLH 


> , 


. 14 


, 17700a 


. DR2, 


X45 


OPCHEF 


<LOCLF 


> t 


f 14 


, 177000 


, HR2 


X45 


OPCHEF 


<LHH 


>, 


11, 


17240a 


, HR2, 


X45 


OPCHEF 


<LHEXP 


> 


14 


, 17640a 


, DR2 


X45 


OPCHEF 


<UDF 


> 


It 


17240a 


, DR2 


X45 


OPCHEF 


<LDFPS 


>, 


01, 


170100, 




X45 


OPCHEF 


<LHSC 


>, 


m 


170004, 




X45 


OPCOFF 


<LHUB 


>, 


, 00 


170003 




X45 


OPCHEF 


<MARK 


>, 


10, 


, 00640a, 




X45 


OPCHEF 


<MFPO 


>, 


01, 


, 10650a, 




X45 


OPCHEF 


<MFPT 


>, 


All 


, 00650a, 




X45 


OPCHEF 


<MODD 


>, 


11, 


171400, 


DR2, 


X45 


OPCHFF 


<MOOF 


>., 


Hi 


17140a, 


, HR2, 


X45 


OPCHEF 


<MOV 


>, 


02, 


,~ 0i00aa, 


HR2 




OPCHEF 


<MOVB 


>, 


02, 


, 110000, 


RR2 




OPCHEF 


<MTPD 


>, 


01. 


10660a, 


HR1. 


X45 


OPCHEF 


<MTPI 


>, 


01, 


, 00660a, 


HR1, 


X45 


OPCHEF 


<MUL 


>, 


07, 


070000, 


HR2, 


X40&X45 


OPCHEF 


<MULH 


>, 


11, 


171000, 


HR2, 


X45 


OPCHEF 


<MULF 


>, 


11, 


171000, 


HR2, 


X45 


OPCHEF 


<NEG 


>, 


01. 


, 00540a, 


HR1 




OPCHEF 


<NEGfr 


>, 


01, 


r 10540a, 


PR1 




OPCHFF 


<NEGH 


>, 


01, 


17070a, 


HR1. 


X45 


OPCHEF 


<NEGF 


>, 


01, 


17070a, 


, HR1, 


X45 


OPCHEF 


<NQP 


>, 


00 


, 00024a 






OPCHEF 


<RESFT 


>, 


. 00 


, aaaaas 






OPCHEF 


<ROL 


>, 


01, 


r 006100, 


0R1 




OPCHEF 


<ROLB 


>, 


01, 


, 10610a, 


r DR1 




OPCHEF 


<ROR 


> 


, 01 


, 0.0600a 


r HR1 




OPCHFF 


<RORB 


>, 


01, 


, 10600a, 


r HR1 




OPCHEF 


<RTI 


>l 


, Pi0, 


, 000002, 






OPCHEF 


<RTS 


> 


r 03 


, 00020a 


, HR1 
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opcdef 


<RTT 


>, 


aa, . 


00000*, 


* 


Y45 


OPCDEF 


<SBC 


>, 


01, 


005600, 


DRl 




OPCDEF 


<S8CB 


>, 


01, 


105600, 


DRl 




OPCDFF 


<scc 


>, 


00, 


000277, 






OPCDEF 


<SEC 


>, 


00, 


000261 , 






OPCDFF 


<SEN 


>, 


00, 


0002701 






OPCDEF 


<SETD 


>, 


00, 


170011, 


. 


X45 


OPCDFF 


<SETF 


># 


00, 


170001 . , 


} » 


X45 


OPCDFF 


<SETT 


>, 


00, 


170002 


> « 


Y45 


OPCDFF 


<SETL 


>, 


00, 


170012, 


> . 


X45 


OPCDFF 


<SEV 


>; 


00, 


00026? 






OPCDFF 


<3EZ 


>, 


00, 


000264 






OPCDFF 


<SOB 


>, 


08, 


07700a 


, DRl. 


X45 


OPCDEF 


<SPL 


>, 


13, 


00023(71 


t . 


X45 


OPCDFF 


<STA0 


>, 


00, 


170005 


t . 


X45 


OPCDFF 


<STB0 


>, 


00, 


170006 


t . 


X45 


OPCDFF 


<STCDF 


>, 


12, 


17600a 


, DR2. 


X45 


OPCDFF 


<STCDT 


>, 


12, 


17540a 


, DR2. 


X45 


OPCDEF 


<STCDL 


>, 


12, 


175400, 


, DR2. 


X45 


OPCDEF 


<STCFD 


>, 


12. 


176000, 


, DR2. 


X45 


OPCDFF 


<STCFI 


> , 


12, 


,175400, 


, DR2. 


X45 


OPCDFF 


<STCFL 


> t 


12, 


175400, 


DR2. 


X45 


OPCDEF 


<STD 


>, 


12, 


17400a, 


PR2. 


X45 


OPCDFF 


<STEVP 


>t 


12. 


17500(3, 


DR2. 


X45 


OPCDEF 


<STF 


>, 


12, 


17400PI, 


PR 2. 


X45 


OPCDEF 


<STFPS 


>, 


01, 


170200, 


, DRl. 


X45 


OPCDEF 


<STQ0 


>, 


00, 


170007, 


. 


X45 


OPCDEF 


<STST 


>, 


01. 


170300, 


DRl. 


X45 


OPCDFF 


<SU8 


>t 


02, 


16000a, 


DR2 




OPCDFF 


<SU8D 


> , 


11. 


173000, 


, DR2. 


X45 


OPCDEF 


<SUBF 


>, 


1 1. 


173000, 


, DR2. 


X45 


OPCDFF 


<SWAB 


>, 


01. 


00030a, 


, DRl 




OPCDEF 


<8XT 


>, 


01. 


^f>7^?i 


, DRl. 


X45 


OPCDEF 


<TRAP 


>, 


06, 


104400 






OPCDEF 


<TST 


> f 


01. 


005700 






OPCDFF 


<TSTB 


># 


01, 


10570a 






OPCDEF 


<TSTD 


>, 


01, 


170500 


t * 


X45 


OPCDFF 


<T8TF 


>, 


101. 


170500 


i . 


X45 


OPCDEF 


<WAIT 


>, 


00, 


000001 






OPCDFF 


<XOR 


>, 


05, 


07400a 


, DR2. 


X45 


DIRDEF 


<ASCII 


>. 


DFI GBM 








DIRDEF 


<ASCIZ 


>. 


DFLGBM 








DIRDEF 


<ASECT>. 


» 


VREL 






DIRDEF 


<BLKB 


> 










DIPDFF 


<BLKW 


>. 


DF| GEV 








DIRDEF 


<8YTE 


>. 


DFLGBM 








DIRDEF 


<CSECT>. 


# 


XREL 






'.IF DF 


YPHASF 












DIPDFF 


<DEPHA> 










.ENDC 














DIRDEF 


<DSABL> 










DIPDFF 


<ENABL> 










DIRDEF 


<FND 


> 










DIRDEF 


<ENDC 


>. 


DFLCMD 








DIRDF1 


<ENDM 


>.-EMDM, 


DFLMAC.VMACRO 






DIPDF1 


<ENDR 


>.EmDm, 


DFlMAr.XMACRO 






DIRDEF 


<EOT 


> 










DIRDFF 


<ERROR> 










DIRDFF 


<EVEN 


> 










DIRDEF 


<FLT2 


>. 


DFLGFV, 


XFLTG 






DIRDEF 


<FLT4 


>. 


DFLGFV, 


XFLTG 






DIRDFF 


<GLOBL>» 


. 


XRFL 






DIPDFF 


<IDENJT> 
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OIPHFF 


<IF >. 


PFl CMP 




PIRDF1 


<IFDF >.IFPF, 


,DFl. CNn 




PlPHFi 


<IFEQ >.IFPF, 


,DFl.CNr> 




nipnFF 


<IFF >. 


PFJ.CMO 




PIROF1 


<IFG >.IFDF, 


,DF| CMH 




PIPPF1 


<IFGF >.IFPF, 


rPFLC^n 




PIPPF1 


<IFGT >.IFPF, 


, PFL CNn 




PIPHF1 


<IFL >.IFPF, 


-PFl CMP 




PIPPFI 


<IFLF >.IFPF, 


-PFLCNH 




DIPHF1 


<IFLT >.IFPF < 


,PFLCND 




PIRPF1 


<IFNPF>,IFPF, 


rPFl CVP 




PIPPFI 


<IFNF >.IFDF, 


rDFLCNH 




pIRDFl 


<IFN7 >.IFDF ( 


,PF| CNP 




dirpef 


<IFT >. 


f>F| CNO 




plRfiFF 


<IFTF >. 


PFLCNP 




pIRPFl 


<IFZ >.TFPF, 


.DFLCNh 




OIPHEF 


<IIF > 






PIRHEF 


<IRP >. 


RFIMAC, 


XMACRn 


pIRPFF 


<IRPG >. 


PFiMAC, 


XMACRn 


DIRHFF 


<LIMIT>, 


PFI.GFV, 


XREL 


PIRPEF 


<LIST > 






DIRRFI 


<HACR >.MACR, 


PFLMAf.yMACRO 


DlROFl 


<MACRO>,MAC«, 


DFLMAr.yMACPO 


pIRPEF 


<MCALL>» 


PFJ SMC, 


XSML 


pIRPEF 


<MEXIT> , 


* 


XMACRO 


DIRHFF 


<MARG > , 


r 


XMACRn 


PIRPEF 


<NCHR > , 


t 


XMACRn 


PIRPEF 


<NLI3T> 






PIRPEF 


<NTYPE> , 


9 


XMACRn 


pIRPEF 


<ODD > 






plRDFF 


<PAGE > 






.IF pF 


YPHASE 






DIPDFF 


<PHA8E> 






„FNPC 








PIRDFF 


<PRINT> 






PIRPEF 


<PSECT> 






- DtRf>FF 


<RADIX> 






PIRPEF 


<RAD50>» 


PFI.GFV 




DIRHEF 


<REM > * 






DIRDEF 


<REPT >, 


PF| MAC, 


XMACRn 


PIRPEF 


<SBTTL> 






PIRPEF 


<TITLE> 






WROSYMm 




jRFF LABFL 


PIPHEF 


<WORD >. 


PFl GFV 




PSTTOPt* 




1RFF LABFL 



.ENP 
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PART 6 

CHAPTER 10 

WRITING POSITION-INDEPENDENT CODE 

All addressing modes involving only register references are position-independent. 
These modes are as follows. 

R register mode 

@R deferred register mode 

(R)+ autoincrement mode 

@(R)+ deferred autoincrement mode 

-(R) autodecrement mode 

@-(R) deferred autodecrement mode 

When using these addressing modes, position-independence is guaranteed providing 
the contents of the registers have been supplied such that they are not dependent 
upon a particular core location. 

The relative addressing modes are generally position-independent. These modes 
follow. 

A relative mode 
@A relative deferred mode 

Relative modes are not position-independent when A is an absolute address (that is, 
a nonrelocatable address) that is referenced from a relocatable module. 

Index modes can be either position-independent or nonposition-independent, according 
to their use in the program. These modes follow here. 

X(R) index mode 
@X (R) < index deferred mode 

If the base X is position-independent, the reference is also position- independent. 
For example: 

MOV 2(SP),R0 ; POSITION- INDEPENDENT 

N=4 

MOV N ( SP ) , R0 ; POS ITION- INDEPENDENT 

ADDR: CLR ADDR(Rl) : NONPOSITION-INDEPENDENT 

Caution must be exercised in the use of index modes in position-independent code. 

Immediate mode can also be either position-independent or not, according to its 
usage. Immediate mode references are formatted as shown here. 

#N immediate mode 



6-93 



where N is an absolute number or a symbol defined by an absolute direct assignment, 
the code is position-independent. When a label replaces N, the code is nonposition- 
independent. (That is, immediate mode references are position-independent only 
where N is an absolute value.) 

Absolute mode addressing is unlikely to be position-independent and should be 
avoided when coding position-independently. Absolute mode addressing references 
are formatted as shown here. 



<a#A 



absolute mode 



Since this mode is used to obtain the contents of a specific core address, it 
violates the intentions of position-independent code. 

Such a reference is position-independent if A is an absolute address. 

Position-independent code, is used in writing programs such as device drivers and 
utility routines, which are most useful when they can be brought into any available 
core space. Figure 6-9 and Figure 6-10 show pieces of device driver code; one is 
position-independent and one is not. 



DVRINT — ADDRESS OF DEVICE DRIVER INTERRUPT SERVICE 
VECTOR — ABSOLUTE ADDRESS OF DEVICE "INTERRUPT VECTOR 
DRIVER — START ADDRESS OF DEVICE DRIVER 



MOV #DVRINT, VECTOR 
MOVB DRIVER+6 , VECTOR+2 

CLRB VECTOR+3 



;SET INTERRUPT ADDRESS 

;SET PRIORITY 

; CLEAR UPPER STATUS BYTE 



Figure 6-9 
Nonposition-independent Code 



MOV 


PC,R1 


ADD 


#DRIVER-.,R1 


MOV 


# VECTOR, R2 


CLR 


@R2 


MOVB 


5(R1) ,@R2 


ADD 


R1,(R2)+ 


CLR 


@R2 


MOVB 


6(R1),@R2 



;GET DRIVER START 

...& VECTOR ADDRESSES 
SET INTERRUPT ADDRESS 
. . .AS START ADDRESS+OFFSET 

;SET PRIORITY 



Figure 6-10 
Position-independent Code 
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In both examples the program calling the device driver has correctly initialized 
its interrupt vector (VECTOR) within absolute memory locations 0-377. The 
interrupt entry point offset is, in byte DRIVER+5. (The contents of the driver 
table shows at DRIVER+5: .BYTE DVRINT , DRIVER . ) The priority level is at byte 
DRIVER+6. 

In. the first example, the interrupt address is directly inserted into the absolute 
address of VECTOR. Neither of these addressing modes is position-independent. 

The instruction to initialize the driver priority level uses an offset from the 
beginning of the driver code to the priority value, and places that value into the 
absolute address VECTOR+2, which is not position-independent. The final operation 
clearing the absolute address VECTOR+3 is also not position-independent. 

In the position-independent code, operations are performed in registers wherever 
possible. The process of initializing registers is carefully planned to be 
position-independent. For example, the first two instructions obtain the starting 
address of the driver. The current PC value is loaded into Rl, and the offset from 
the start of the driver to the current location is added to that value . Each of 
these operations is position-independent. The immediate mode value of VECTOR is 
loaded into R2, which places the absolute address of the transfer vector into a 
register for later use. The transfer vector is then cleared, and the offset for 
the driver starting address is loaded into the vector. Thi starting address of 
the driver "as then added into the vector, giving the desired entry point to the 
driver. (This is equivalent to the first statement. in Figure 6-9.) Since R2 has 
been updated to point to VECTOR+2 , that location is then cleared and the priority 
level inserted into the appropriate byte. 

The position-independent code demonstrates a principle of PDP-11 coding practice 
discussed earlier; that is, the programmer is advised to work primarily with 
register addressing modes wherever possible, relying oh the setup mechanism to 

determine position-independence. 

i 

The MACRO Assembler provides the . user with a way of checking the position- 
independence of the code. In an assembly listing, MACRO inserts a ' character 
following the contents of any word that requires the Linker to perform an operation. 
In some cases this character indicates a nonposition-independent instruction; in 
other cases it merely draws the user ' s attention to the use' of a symbol that may 
or may not be position-independent. The cases that cause a * character in the 
assembly listing follow. 
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Absolute mode symbolic references are flagged with an ' character when 
the reference is not position-independent. References are not flagged 
when they are position-independent (i.e., absolute). For example: 



MOV @#ADDR,R1 



;PIC ONLY IF ADDR IS ABSOLUTE. 



Index mode and index deferred mode references are flagged with an * 
character when the base is a symbolic label address (relocatable rather 
than an absolute value) . For example: 



MOV ADDR(Rl) ,R5 
MOV @ADDR(R1) ,R5 



;NON-PIC IF ADDR IS RELOCATABLE. 
; NON-PIC IF ADDR IS RELOCATABLE. 



Relative mode and relative deferred mode are flagged with an 
when the address specified is a global symbol. For example: 



character 



MOV GLB1,R1 
MOV @GLBl,Rl 



; PIC WHEN GLB1 IS A GLOBAL SYMBOL. 
;PIC WHEN GLB1 IS A GLOBAL SYMBOL. 



If the symbol is absolute, the reference is flagged and is not position- 
independent. 

Immediate mode references to symbolic labels are always flagged with an 
• character . 



MOV #3,R0 
MOV #ADDR,R1 



; ALWAYS POS ITION-INDEPENDENT . 

; NON-PIC WHEN ADDR IS RELOCATABLE. 



Examples of assembly listings containing the ' character are shown in Figure 6-11. 



1 |Zfll744 ENDP2: 






;END OF PASS 2 


2 


.IF NDF 


XCREF 




3 011744 016702 


MOV 


CRFPNT,R2 


;ANY CREF IN PROGRESS? 


000142 » 








4 011750 001402 


BFQ 


8$ 


; NO 


5 011752 


CALL 


CRFDMP 


;YES, DUMP AND CLOSE B 


6 011756 8$: 








7 


.ENDC 






8 011756 005767 


TST 


BLKTYP 


;ANY OBJECT OUTPUT? 


000542 ' 








9 011762 001423 


BFQ 


1$ 


; NO 


10 11764 


CALL 


OPJDMP 


;YES, DUMP IT 


11 11770 012767 


MOV 


#PLKT06, BLKTYP 


;SET END 


000006 








000542 ' 








12 11776 


CALL 


RLDDMP 


;DUMP IT 


13 


,IF NDF 


XFDABS 


" 


14 12002 032767 


BTT 


#FD.ABS,EDMASK 


;ABS OUTPUT? 


000002 








000124 ■ 








15 12010 001010 


BNE 


1$ 


; NO 


16 12012 016700 


MOV 


OBJPNT,R0 




000536' 




. 




17 12016 016720 


MOV 


ENDVEC+6, (R0) + 


;SET END VECTOR 


000044 " 








18 12022 010067 


MOV 


R0,OBJPNT 




000536' 








19 12026 


CALL 


OBJDMP 




20 


,FNDC. 







Figure 6-11 * 
Assembly Listing Showing ' Character 



Continued on next page 
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21 12032 105767 1$: 


TSTR 


LLTPL+2 


;ANY LISTING OUTPUT? 


000546 • 








22 12036 001474 


BFQ 


15$ 


; NO 


23 12040 032767 


BIT 


#LC.SYM,LCMASK 


; SYMBOL TABLE SUPPRESSION? 


040000 








000110' 









Figure 6-11 
Assembly Listing Showing ' Character 
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